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About IBM Content Manager OnDemand for iSeries Common 
Server Web Enablement Kit Installation and Configuration 
Guide (SC27-1163) 


This book provides information that you can use to plan for, install, configure, and 
use IBM Content Manager OnDemand for iSeries Version 5 Release 2 Common 
Server Web Enablement Kit (OQDWEK). 


Who should read this book 


This book is intended primarily for system administrators who need to implement, 
install, and maintain the ODWEK software and applications. It can also be used by 
programmers who need to integrate OnDemand with Web applications. 


How this book is organized 


This book provides the information that you need to install and configure OODWEK 
and plan for users to access data from an IBM Content Manager OnDemand for 
iSeries Common Server (OnDemand) system with a Web browser. This publication 
contains the following sections: 


* |Chapter 1, “Overview” on page 1 


* |Chapter 4, “Installing the Web viewers” on page 39 
: 
; 

: 


ee G “No HTML output” on a 83 


Appendix H, “Problem determination tools” on page 87| 


Prerequisite and related information 


Use the IBM iSeries Information Center as your starting point for looking up 
iSeries technical information. 


You can access the Information Center two ways: 
* From the following Web site: http://www. ibm.com/eserver/iseries/infocenter 
* From CD-ROMs that ship with your Operating System/400® order: 


iSeries Information Center, SK3T-4091-02. This package also includes the PDF 
versions of iSeries manuals, iSeries Information Center: Supplemental Manuals, 
SK3T-4092-01, which replaces the Softcopy Library CD-ROM. 


The Information Center contains advisors and important topics such as Java’, 
TCP/IP, Web serving, secured networks, logical partitions, clustering, CL 
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commands, and system application programming interfaces (APIs). It also includes 
links to related IBM Redbooks'” and Internet links to other IBM Web sites such as 
the IBM home page. 


Other information available on the World Wide Web 


More iSeries information is available on the World Wide Web. You can access 
general information from the iSeries home page, which is at the following Web 
site: http: //www-1.ibm.com/servers/eserver/iseries/ 


To access workshops on advanced iSeries functions, use the Technical Studio, 
located at: http://www.iseries.ibm.com/tstudio/ 


Worldwide, you can read about, select, order and take delivery of iSeries program 
temporary fixes (PTF) over the Internet. iSeries Internet PTFs (downloads) and 
Preventive Service Planning (PSP) information are available at the following 
Internet location: http://as400service.ibm.com 


iSeries Navigator 


IBM iSeries Navigator is a powerful graphical interface for managing your iSeries 
servers. iSeries Navigator functionality includes system navigation, configuration, 
planning capabilities, and online help to guide you through your tasks. iSeries 
Navigator makes operation and administration of the server easier and more 
productive and is the only user interface to the new, advanced features of the 
OS/400®. It also includes Management Central for managing multiple servers from 
a central system. 


You can find more information on iSeries Navigator in the IBM iSeries Information 
Center and at the following Web site: 
http://www. ibm.com/eserver/iseries/navigator/ 


How to send your comments 


Your feedback is important to providing the most accurate and high-quality 
technical documentation. Please send any comments that you have about this 
publication or other OnDemand documentation. You can use either of the 
following methods to provide comments: 


* Fax your comments from the United States, Canada, and Puerto Rico to 
1-800-937-3430 (From other countries: 1-507-253-5192) 


* Email your comments to: RCHCLERK@us.ibm.com; for the Information Center, 
email comments to: RCHINFO@us.bim.com 


Be sure to include the following information: 
* The name of the book of iSeries Information Center topic 


* The publication number of a book (found in the lower right corner of the books 
front cover 


* The page number or topic to which your comment applies 
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| Summary of Changes 


This edition of IBM Content Manager OnDemand for iSeries Common Server: Web 
Enablement Kit Installation and Configuration Guide contains new and changed 
technical information. There may be some instances where changes were made, but 
change bars are missing. Significant changes to note are: 


You can automate the loading of non-spooled file data such as PC files in IFS with 
the Start Monitor for OnDemand (STRMONOND) command using *DIR (directory) 
for the TYPE parameter. See Appendix A of the IBM Content Manager OnDemand for 
iSeries Common Server: Administration Guide for information on the STRMONOND 
command. 


Additional keywords have been added to many OnDemand commands to more 
precisely identify the spooled file that the command will use. The new keywords 
correspond to the same new keywords available for OS/400 spooled file 
commands, allowing you to specify the system on which the spooled file was 
created, as well as the spooled file creation date and time. 


Portable Application Solutions Environment (PASE), a product option of OS/400, is 
now an optional software prerequisite for the OnDemand Common Server. PASE is 
required if you plan to use the new OnDemand Common Server text search 
function for AFPDS documents. It is also possible that, in the future, other new 
functions of OnDemand may require PASE. 


Additions and enhancements have been made to the sample programs for both 
Common Server and Spool File Archive. Sample programs for Common Server can 
be found in QSAMPLES2 source file in library QRDARS. Sample programs for 
Spool File Archive can be found in QSAMPLES source file in library QRDARS. 


Record Archive provides commands and application programming interfaces 
(APIs) that let you store and retrieve data records on optical media for users who 
only require occasional access to historical data. At Version 5 Release 2, this 
product option is provided for existing Record Archive customers to use, but there 
are no planned enhancements. Documentation can be found in OnDemand 
publications from previous releases. Please talk to your software provider about 
other options, such as compressed DASD. 
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Chapter 1. Overview 


ODWEK allows people in an organization to use a Web browser to access data 
stored in an OnDemand system. For example, you can provide some people with 
the Uniform Resource Locator (URL) of a Web page that permits them to log on to 
an OnDemand server; you can provide other people with the URL of a Web page 
that permits them to search a specific folder. ODWEK verifies that the user 
information is valid on the OnDemand server, such as permission to access the 
server and data stored in an application group. After the user submits a search, 
ODWEK displays a Web page that contains a list of the documents that match the 
query. The user selects a document to view and ODWEK sends the document to 
the browser. 


[Figure 1|shows a workstation with a Web browser that is being used to access data 
from an OnDemand server. 


OnDemand Server Instance 
Web Server 
OnDemand Web Enablement Kit 


World Wide Web 
(Internet) 


= =I 
== 


Web Browser 


Figure 1. Accessing data stored in OnDemand using ODWEK 


ODWEK contains several components: 


* The Web server program. The server program uses standard OnDemand 
interfaces and protocols to access data stored in an OnDemand server. No 
additional code is needed on the OnDemand server to support ODWEK. You 
can use one of the following Web server programs to control ODWEK: 


— Common Gateway Interface (CGI) program. The CGI program runs on a 
system that is running an Hypertext Transfer Protocol (HTTP) server, such as 
the IBM HTTP Server. 

— Java servlet. The servlet runs on a Java-enabled HTTP server that is running a 
Java application server, such as the IBM WebSphere® Application Server. 

* Java API. A set of APIs that reproduce the CGI interface for Java developers. The 

APIs require Java version 1.2.2 or later. 

* The IBM OnDemand Advanced Function Presentation™ (AFP"™") Web Viewer. 

The AFP Web Viewer lets users search, retrieve, view, navigate, and print AFP 

documents from a Web browser. 


™ 


* The IBM OnDemand Image Web Viewer. The Image Web Viewer lets users 
search, retrieve, view, navigate, and print BMP, GIF, JPEG, PCX, and TIFF 
documents from a Web browser. 


* The Line Data Java applet. The Line Data applet lets users view line data 
documents from a Web browser. An administrator enables the use of the Line 
Data applet by configuring the ARSWWW.INI file. 

* The AFP2HTML Java applet. The AFP2HTML applet lets users view the output 
generated by the IBM AFP2WEB Transform service offering. The AFP2WEB 
Transform converts AFP documents and resources into Hypertext Markup 
Language (HTML) files that can be displayed with the AFP2HTML applet. After 
installing and configuring the AFP2WEB Transform, an administrator enables the 
use of the AFP2HTML applet by configuring the ARSWWW.INI file. 
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Note: To view other types of documents stored in OnDemand, you must obtain 
and install the appropriate viewer. For example, to view Adobe Portable 
Data Format (PDF) documents, IBM recommends that you obtain the Adobe 
Acrobat viewer for the browsers that are used in your organization. 


About the viewers 
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ODWEK provides the following viewers: 
¢ AFP Web Viewer 

* Image Web Viewer 

* Line Data Java applet 

¢ AFP2HTML Java applet 


The AFP Web Viewer and the Image Web Viewer are software programs that 
extend the capabilities of a Web browser in a specific way. The AFP Web Viewer 
lets users view AFP documents. The Image Viewer lets users view BMP, GIF, JPEG, 
PCX, and TIFF documents. The viewers provide the capability to display 
documents in the browser window. Each viewer adds a toolbar to the top of the 
display window. The viewer toolbar may be in addition to the browser’s toolbar. 
The plug-in toolbar provides controls that can help users work with documents. 
The people in your organization that plan to use the Web viewers to view 
documents must install them on their workstations. 


Note: The installation program will install the viewers as either plug-ins or 
ActiveX controls. If Internet Explorer is installed on the workstation, then 
the installation program will install the ActiveX controls; if Netscape is 
installed on the workstation, then the installation program will install the 
plug-ins. If you have both Internet Explorer and Netscape installed on the 
workstation, then the installation program will install the ActiveX controls 
for Internet Explorer and the plug-ins for Netscape. 


The Line Data applet lets users view SCS, SCS-extended, and line data documents 
that are stored in OnDemand. The Line Data applet displays line data documents 
in the browser window and adds a toolbar to the top of the display window. The 
Line Data applet toolbar provides controls that can help users work with 
documents. An administrator enables the use of the Line Data applet by 
configuring the ARSWWW.INI file. 


The AFP2HTML applet lets users view the output generated by the IBM AFP2WEB 
Transform service offering. The AFP2WEB Transform converts AFP documents and 
resources into HTML documents. After installing and configuring the AFP2WEB 
Transform, an administrator enables the use of the AFP2HTML applet by 
configuring the ARSWWW.INI file. The AFP2HTML applet provides a toolbar with 
controls that can help users work with documents, including controls for large 
objects. 


One advantage of the applets is that your users never have to install or upgrade 
software on the workstation to use them, unlike the Web viewers, which must be 
installed on the workstation. Also, if IBM provides a new version of a Web Viewer, 
then you must distribute the updated Web Viewer to your users. 


When using the applets and viewers that are provided by IBM, the documents that 
are retrieved from an OnDemand server remain compressed until reaching the 
client. The client uncompresses the documents and displays the pages in a Web 
browser window. If a document was stored in OnDemand as a large object, then 
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the client retrieves and uncompresses segments of the document, as needed, when 
the user moves through pages of the document. 


Using ODWEK 


The most common method of using ODWEK is by customizing the sample HTML 
applications provided with the product. The LOGON.HTM sample application 
supports users that are permitted access to several folders. You first modify the 
LOGON.HTM page with information about your OnDemand server. You then 
publish the URL of the LOGON.HTM file. Your users can then link to the URL and 
log on to the specified server. ODWEK automatically displays a series of Web 
pages for users to search for, retrieve, and display OnDemand documents. The 
CREDIT.HTM sample application supports casual use of OnDemand by providing 
a Web page that contains search criteria for a specific folder. After you customize 
the sample, the user links to the URL, completes the search criteria, and presses the 
Submit button. ODWEK displays a Web page that lists the documents that match 
the query. 


Important: ODWEK requires the ability to write cookie data on the client. Make 
sure that your users configure their browsers to accept cookies. 


Most customers define one OnDemand userid to access a server with ODWEK. 
This is common in environments with many casual users of OnDemand who will 
be accessing the same folder. You can also provide each user with their own 
OnDemand userid. Regardless of how you decide to access OnDemand with 
ODWEK, you must manage the userids in OnDemand: you must add them to the 
server and set application group and folder permissions for the users. 


Product functions 


The following OnDemand functions are supported by ODWEK. You typically 
invoke the functions by creating Web pages that contain links to the OODOWEK 
server program. Each link invokes a specific function. The output of one function 
is another Web page with links that lead the user to the next logical function. For 
example, the initial Web page may invoke the Logon function. The Logon function 
generates a Web page with a link to the Search Criteria function. Each function can 


be called with an Application Programming Interface (API). See|Appendix C, “API 
feference” on page 43 


eference” on page 49}for details. 


Add Annotation 


The Add Annotation function enables users to add an annotation to the specified 
document. To add an annotation, the user must be given the Annotation Add 
permission for each application group that contains documents to be annotated. 
(The Application Group Access permission lets users add annotations.) 


Change Password 


The Change Password function allows users to change their OnDemand 
passwords. 


Document Hit List 


The Document Hit List function builds the list of items that match the search 
criteria. The list is presented in an HTML table. Each item that matches the search 
is stored in a table cell and contains a link to the Retrieve Document function. 
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Logoff 


The Logoff function allows users to log off an OnDemand server. 


Logon 
The Logon function allows the users to logon to an OnDemand server. If the 


Logon function is successful, the user is presented with a Web page that contains 
the list of folders that the user is authorized to open. 


Retrieve Document 


The Retrieve Document function retrieves a document from OnDemand. The data 
stream returned from the server includes the document, and depending on the 
data type, the resources required to view the document. The data stream must not 
be modified in any way. The browser, along with the viewer, interpret and decode 
the data stream and display the document. If the document is stored in OnDemand 
as a large object, then only the first segment of the document is returned. 
Subsequent segments of the document are retrieved and displayed as needed. 


Search Criteria 


After a successful logon, the user is presented with the list of folders that the user 
is authorized to open. The user selects a folder to open. Upon opening a folder, a 
Web page is displayed that contains the search fields for the folder. The user can 
accept the default search criteria or enter search criteria to search for specific 
documents. When the user presses the Submit button, the search request is sent to 
the OnDemand server. 


Server Print Document 


The Server Print Document function sends copies of documents to an OnDemand 
server printer. To use server print, the user must be given the Document Print 
permission for each application group that contains documents that the user needs 
to print. (The Application Group Access permission lets users print documents.) At 
least one server printer must be defined on the OnDemand server. 


Update Document 


The Update Document function allows users to update the database. The Update 
Document function updates one or more database fields for a specific document. 


View Annotations 


The View Annotations function enables users to view the annotations attached to 
the specified document. To view annotations, the user must be given the 
Annotation View permission for each application group that contains annotations 
that the user needs to view. (The Application Group Access permission lets users 
view annotations.) 


Server and data security 
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There are two levels of security that you need to consider before you use ODWEK: 
* Who can access the ODWEK programs and the Web pages 
* Who can access data on the OnDemand server 


Any user that can access your Web server and the programs and Web pages that 
comprise the front-end to ODWEK can potentially access data stored in 
OnDemand. IBM strongly encourages you to limit access to the programs and Web 
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pages. There are many ways that you can limit access to programs and Web pages 
on your Web server. For example, many Web servers provide a system of security 
to sensitive Web pages by allowing you to restrict access to directories. You can 
also use a password file on the Web server, that requires users to enter a userid 
and password before accessing the Web pages. However, even though Web server 
userids and passwords are similar to operating system userids and passwords, 
there is no correspondence between them and operating system userids and 
passwords. There is also no correspondence between Web server userids and 
passwords and OnDemand userids and passwords. 


ODWEK provides access to OnDemand servers and data using standard 
OnDemand APIs. The APIs verify that the OnDemand userid can access the server 
and the requested data. Someone in your organization must administer user and 
data security on the OnDemand server. 


There’s one other security-related detail that you might want to consider: the 
method used to transfer form parameters and values between the client and the 
server. The forms provided with ODWEK use the POST method to transfer 
parameters and values within the body of the HTTP request. With the POST 
method, the parameters and values do not appear in the Location field of the 
browser. For example, a typical function call appears as follows: 


http://www. company.com/cgi-bin/arswww.cgi 


However, if you do not specify a method when you create a form, then the default 
method is GET, which transfers parameters and values within the URL itself. With 
the GET method, a typical function call appears as follows: 


http://www. company.com/cgi-bin/arswww.cgi?_function=logon 
& user=bob&_password=secret 


The parameters and values appear as clear text in the Location field of the browser 
window. If you create your own forms, IBM strongly encourages you to use the 
POST method. To change the default method from GET to POST, you must code 
the METHOD attribute on the form tag. 


Note: If you must use the GET method, then you can encrypt the parameters and 


values by specifying the ENCRYPTURL parameter in the ARSWWW.INI file. 
See}“ENCRYPTURL” on page 29] for more information. 
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Chapter 2. Installing and configuring the Web server 


This section defines the installation requirements and explains how to install the 
ODWEK software on the Web server and modify the ODWEK configuration file. 


You must install the ODWEK software on an iSeries system that is running the 
current version of the IBM HTTP Server. In addition, if you plan to use the Java 
servlet, then make sure that you have the current version of the iSeries Web 
Application Server (WebSphere) up and running. 


ODWEK can search for and retrieve documents from OnDemand servers that are 
running IBM Content Manager OnDemand for iSeriesVersion 5 Release 1 Common 
Server. 


Installation requirements 


ODWEK requires: 


* The current version of the IBM HTTP Server. In addition, if you plan to use the 
Java servlet, then make sure that you have the current version of the iSeries Web 
Application Server (WebSphere) up and running. The servers must run under 
OS/400 V5R1. 


* Appropriate media type for installation. 


* Adequate disk space for installation files: approximately 30 MB on the Web 
server 


* Adequate disk space for cache storage: by default, 10 MB on the Web server. See 
“CACHESIZE” on page 13]for more information. 


Other requirements 


ODWEK can cache (temporarily store) documents on the Web server. This can 
increase the speed with which previously viewed documents can be sent to users. 


To enable cache storage for documents, configure the CACHEDOCS parameter in 
the ARSWWWALINI file. See /“CACHEDOCS” on page 12}for details. 

By default, ODWEK caches data in the /QIBM/UserData/OnDemand/WWW/CACHE 
directory. You can specify a different cache directory by modifying the 
ARSWWWALINI file. See /“CACHEDIR” on page 11) for details. 

Make sure that the processes that run ODWEK programs can read from the 
directory that contains the programs and can write to the cache directory. When 
ODWERK is installed, all of the objects are secured by authorization list 


QONDADM and user profiles QTMHHTTP, OTMHHTP1 and QEJBSVR are added 
to the authorization list with *CHANGE authority. 


If you plan to use the AFP2HTML applet, then you must obtain the AFP2WEB 
Transform service offering from IBM and install and configure it on the Web server. 
See your IBM representative for more information about the AFP2WEB Transform 
service offering. You must also provide configuration options for the AFP 
documents and resources that you plan to process with the AFP2WEB Transform. 


the configuration file. 
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If you plan to convert AFP documents stored in OnDemand to PDF documents 
that can be viewed with the Adobe Acrobat viewer, then you must obtain the 
AFP2PDF Transform service offering from IBM and install and configure it on the 
Web server. See your IBM representative for more information about the AFP2WEB 
Transform service offering. You must also provide configuration options for the 
AFP documents_and_ resources that_you plan to process with the AFP2PDF 
information about the configuration file. To view converted documents, you must 
obtain the Adobe Acrobat viewer for the browsers used by your organization. 


Installing on OS/400 
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Setting up ODWEK typically requires that you do the following: 


1. Obtain a copy of the latest OnDemand README file. Print and then read the 
entire file before you begin. 


2. To install ODWEK, follow the instructions in the book named Software 
Installation (SC41-5120). The licensed program number is 5722RD1 and the 
feature is 11. 


Note: The recommended way to install ODWEK is to use the Install licensed 
programs menu option from the Work with Licensed Programs menu (go 
licpgm). From the Install licensed programs screen, enter a 1 to Add an 
option, enter 5722RD1 for the Licensed Program and 11 for the Product 
Option or scroll through the list of Licensed Programs and Product 
Options until you find ODWEK and enter a 1 before it. If you install 
OnDemand with any other method, errors can occur when you attempt 
to use it. 


3. IBM recommends that you order, load, and apply all PTFs available for 
OnDemand after successful installation of the licensed program. Refer to 
Informational APAR II12715 for a complete list of OnDemand Version 5 Release 
1 PTFs. The informational APAR can be ordered electronically using the 
SNDPTFORD command, specifying [112715 for the PTF number. Be sure to read 
the PTF cover letters and follow any special instructions. 


Your next step 


Make sure that you have the current version of the IBM HTTP server up and 


running on the iSeries system. You will need to configure the HTTP server. See 
Appendix E, “HTTP server configuration files” on page 79|/for an example of an 


HTTP server configuration file. 


If you plan to use the Java servlet, make sure that you have the current version of 
the iSeries Web Application Server (WebSphere) up and running. You will need to 
configure WebSphere. For instructions, see the IBM WebSphere Application Server 
for AS/400° Documentation Center on the Web at 

http: //www.ibm.com/servers/eserver/iseries /software /websphere / 
wsappserver/docs/as400v35std/docs/. Follow the links to Installation and Initial 
Configuration. 


After you have installed the ODWEK software, configured the HTTP server, and 


(optionally) configured WebSphere, you can now configure the OODOWEK 
initialization file for your operating environment. See|Specifying the 
IARSWWWAINI file” on page 9 
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Specifying the ARSWWW.INI file 


The ARSWWWAINI file is an ASCII text file that contains parameters that are read 
by ODWEK programs (such as the CGI program or the Java servlet). You specify 
each parameter on a separate line using the following format: PARAMETER=value. For 
example: 

AFPVIEWING=plugin 


CACHEDIR=/tmp/cache 
LANGUAGE=ENU 


The parameters in the ARSWWWAINI file are grouped into sections. You specify the 
beginning of a section using a section header, in the following format: 
[sectionHeader]. You specify the parameters for a section after the section header. 
For example: 

[@SRV@_gunnar] 

HOST=gunnar 


PORT=1446 
PROTOCOL=4 


An example ARSWWW.INI configuration file is provided with the product. The 
example configuration file provides a set of the most commonly used values. 
“Example ARSWWWLINI file” on page 33|/shows the example. 

The sections and parameters for the ARSWWWLINI file are as follows: 


[@SRV@_DEFAULT] 


The default server section. You can use the default server section to specify 
parameters that are common to the OnDemand servers with which ODWEK will 
communicate. The parameters and values that you specify in this section will be 
used unless you specify them in a server section. 


This section has a global scope for all servers, and you specify it only once in the 
ARSWWWALINI file. 


This section is optional. 


This section can contain the following parameters: 


PORT 

The TCP/IP port number that OnDemand servers use to communicate with 
ODWEK. If you do not specify the PORT parameter, then the server uses the port 
number that is specified for OnDemand in the Service Table (WRKSRVTBLE). If 
you do not specify the PORT parameter and OnDemand is not listed in the Service 
Table, then the servers will attempt to use port number 1445. To specify that the 
servers use the port number that is specified for OnDemand in the Service Table, 
specify 0 (zero). 


You can specify this parameter once in the default section. When using the Logon 
API, you can override the specified port number with the _port parameter. 


This parameter is optional. 
Example: 


[@SRV@_DEFAULT] 
PORT=0 
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PROTOCOL 


The networking protocol that OnDemand servers use to communicate with 
ODWEK. You must specify 0 (zero) for TCP/IP. 


You must specify this parameter once in the default section. 


This parameter is optional. If you do not specify this parameter, a value of 0 (zero) 
is used. 


Example: 


[@SRV@_DEFAULT] 
PROTOCOL=0 


[@SRV @_server] 


A server section. You must specify one server section for each OnDemand server 
with which ODWEK will communicate. A server section contains the parameters 
and values for a specific server. The section header must include the string that 
identifies the server. The parameters specified in a server section override the 
parameters found in the default server section. 


You must specify one server section for each server. 
This section is required. 


This section can contain the following parameters: 


HOST 
The name of the OnDemand server. You can specify the TCP/IP address, host 
name alias, or fully-qualified host name of the server. 


You must specify this parameter once in the server section. 
This parameter is required. 


Example: 


[@SRV@_gunnar] 
HOST=gunnar 


PORT 

The TCP/IP port number that the OnDemand server uses to communicate with 
ODWEK. If you do not specify the PORT parameter, then the server uses the port 
number that is specified (or defaulted to) in the default server section. 


You can specify this parameter once in the server section. When using the Logon 
API, you can override the specified port number with the _port parameter. 


This parameter is optional. 


Example: 


[@SRV@_gunnar] 
PORT=0 


PROTOCOL 


The networking protocol that the OnDemand server uses to communicate with 
ODWEK. You must specify 0 (zero) for TCP/IP. 
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You can specify this parameter once in the server section. 


This parameter is optional. If not specified, the value specified (or defaulted to) in 
the default server section is used. 


Example: 


[@SRV@_gunnar] 
PROTOCOL=0 


[CONFIGURATION] 


The CONFIGURATION section contains parameters that are used by ODWEK on 
the Web server. 


This section has a global scope, and you specify it only once in the ARSWWW.INI 
file. 


This section is optional. 


This section can contain the following parameters: 


APPLETDIR 
Identifies the directory that contains the Line Data and AFP2HTML applets. 


Notes: 
1. You can specify a directory name or a pass rule: 

* If you specify a directory name, the directory must be relative to the 
/QIBM/UserData/OnDemand/WWW directory. For example, if you specify 
appletdir=applets, then the applets must exist in the 
/QIBM/UserData/OnDemand/WWW/APPLETS directory. 

* If you specify a pass rule, then it must be defined in the Web server 
configuration file. For example, if you specify appletdir=/applets/, then the 
Web server configuration file must have a pass rule for /applets/. The 
replacement file path of the pass rule must be set to the full path name of the 
directory on the server. For example: 

Pass /applets/* /QIBM/UserData/OnDemand/WWW/APPLETS/* 
2. Verify the permissions of the directory that you specify. The processes that run 

ODWEK programs must read the applet directory. 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is required. 


Example: 


[CONFIGURATION] 
APPLETDIR=applets 


CACHEDIR 
Use to specify the directory on_the Web server in which ODWEK temporarily 


stores (caches) documents (see |’CACHEDOCS” on page 12). By default, ODWEK 
caches documents in the /QIBM/UserData/OnDemand/WWW/CACHE directory. 


Note: Verify the permissions of the directory that you specify. The processes that 


run ODWEK programs must write to and read from the cache storage 
directory. 
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This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. 


Example: 


[CONFIGURATION] 
CACHEDIR=/QIBM/UserData/OnDemand/WWW/CACHE 


CACHEDOCS 


Determines whether ODWEK temporarily stores (caches) documents on the Web 
server. Cache storage can increase the speed with which previously viewed 
documents are retrieved from the server. The default value is 0 (zero), which 
means that cache storage for documents is not enabled. Specify a 1 (one) to enable 


cache storage for documents. If you enable cache storage for documents, verify the 
directory in which ODWEK caches documents (see !CACHEDIR’” on page 11} and 
the amount of disk space reserved for cache storage (see 

page 13). 


Note: IBM recommends that you always enable cache storage for documents when 
you use the Microsoft® Internet Explorer browser and the AFP Web Viewer 
or the Image Web Viewer. 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. However, in general, most customers should always 
configure cache storage for documents. 


Example: 


[CONFIGURATION] 
CACHEDOCS=1 


CACHEMAXTHRESHOLD 

Determines when ODWEK begins deleting data and documents from cache 
storage. ODWEK begins deleting data and documents when the percentage of disk 
space used in cache storage is equal to or greater than the value specified. The 
default value is 80 (eighty percent). ODWEK deletes the oldest items in cache 


storage until a threshold is reached (see |“CACHEMINTHRESHOLD”). 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. 


Example: 


[CONFIGURATION] 
CACHEMAXTHRESHOLD=80 


CACHEMINTHRESHOLD 

Determines when ODWEK stops deleting data and documents from cache storage. 
ODWEK stops deleting data and documents when the percentage of disk space 
used in cache storage is less than or equal to the value specified. The default value 


is 40 (forty percent). ODWEK begins deleting the oldest items in cache storage 
when a threshold is reached (see |“CACHEMAXTHRESHOLD”). 
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This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. 


Example: 


[CONFIGURATION] 
CACHEMINTHRESHOLD=40 


CACHESIZE 

The amount of disk space that ODWEK can use to temporarily store (cache) data 
and documents on the Web server. Specify the value in megabytes. The default 
value is 10 (ten megabytes). 


Note: To enable cache storage for documents, see|“CACHEDOCS” on page 12 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. However, when caching documents, the more disk 
space that you allocate, the more documents ODWEK can store on the Web server. 
Generally, this can increase the speed with which ODWEK sends previously 
viewed documents to users. 


Example: 


[CONFIGURATION] 
CACHESIZE=1024 


CACHEUSERIDS 

Specifies a comma separated list of OnDemand userids for which ODWEK uses 
data from cache storage to complete the logon process. For the specified userids, 
multiple logon attempts will bypass the standard OnDemand logon processing, 
except if the data is not in cache storage or if the Inactivity Time Out value (see the 
system parameters on the OnDemand server) is reached. Separate each userid with 
the comma character. 


Notes: 

1. If the userid is case sensitive on the server (see the system parameters on the 
OnDemand server), then you must specify the userid exactly as it was defined 
to OnDemand. 

2. The userids listed in the CACHEUSERIDS list can access only those folders 
whose names and other information are in cache storage. The users will not be 
able to access folders created after they log on to an OnDemand server. To 
allow a userid listed in the CACHEUSERIDS list to access a new folder, either 
delete the user’s name from the CACHEUSERIDS list or purge the cache. 

3. To specify that ODWEK should use data from cache storage for all OnDemand 
users, specify CACHEUSERIDS=*. 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. 
Example: 


[CONFIGURATION] 
CACHEUSERIDS=userl,user2,user3 
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CODEPAGE 
Identifies the code page of the OnDemand database. By default, ODWEK uses the 


code page of the Web server. 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. When using the Logon API, you can override the 
specified code page with the _codepage parameter. 


This parameter is optional. However, if the Web server is running in a different 
code page than the database, then you must specify the CODEPAGE parameter. 


Example: 


[CONFIGURATION] 
CODEPAGE=37 


IMAGEDIR 
Identifies the directory that contains image files used by ODWEK. 


Notes: 
1. ODWEK concatenates the value that you specify with the file names found on 
HTML image tags. For example, if you specify: 
imagedir=pictures 


Then the HTML image tag for the View Document function will appear in the 
output as follows: 
<IMG SRC="pictures/odic_vd.gif"> 
2. You can specify a directory name or a pass rule: 

* If you specify a directory name, then the directory must be relative to the 
/QIBM/UserData/OnDemand/WWW directory. For example, if you specify 
imagedir=pictures, then the images must exist in the 
/QIBM/UserData/OnDemand/WWW/PICTURES directory. 

* If you specify a pass rule, then it must be defined in the Web server 
configuration file. For example, if you specify imagedir=/pictures/, then the 
Web server configuration file must have a pass rule for /pictures/. The pass 
rule must be set to the full path name of the directory on the server. For 
example: 

Pass /pictures/* /QIBM/UserData/OnDemand/WWW/PICTURES/* 
3. Verify the permissions of the directory that you specify. The processes that run 

ODWEK programs must read the image directory. 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is required. 


Example: 


[CONFIGURATION] 
IMAGEDIR=pictures 


LANGUAGE 
Identifies the language in which ODWEK displays messages. The default language 
is English (ENU). ODWEK supports the following languages: 


Value Country or Region 


ARA Egypt 
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Value Country or Region 
CHS China 

CHT Taiwan 

DAN Denmark 

DEU Germany 

ENU U.S.A. / English 
ESP Spain 

FIN Finland 

FRA France 

FRC Canada 

ITA Italy 

JPN Japan 

KOR Korea 

NLD Netherlands 
NOR Norway 

PTB Brazil 

SVE Sweden 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. 


Example: 


[CONFIGURATION] 
LANGUAGE=JPN 


TEMPDIR 
Use to specify the directory in which ODWEK will store temporary files. 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. If you do not specify the TEMPDIR parameter, OOWEK 
will store temporary files in the run-time directory. If you are using the CGI 
program, the run-time directory is the directory in which the CGI program was 
installed. If you are using the servlet, the run-time directory is the directory that 
contains the servlet: for some installations, the run time directory is the location of 
the java.exe file; for others, the run time directory is the servlets directory, 
however, the exact location is dependent on the Java application server. 


Example: 


[CONFIGURATION] 
TEMPDIR=/QIBM/UserData/OnDemand/WWW/TMP 


Note: Verify the permissions of the directory that you specify. The processes that 


run ODWEK programs must write to and read from the temporary 
directory. 
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TEMPLATEDIR 

Identifies the directory that contains the HTML template files. ODWEK uses the 
template files to generate Web pages in response to the various product functions 
(such as Logon, Search, Retrieve Document, and so forth). By default, ODWEK 
retrieves the template files from the /QIBM/UserData/OnDemand/WWW/SAMPLES 
directory. 


Note: Verify the permissions of the directory that you specify. The processes that 
run ODWEK programs must read the template directory. 


This parameter has a global scope, and you specify it only once in the 
CONFIGURATION section. 


This parameter is optional. 


Example: 


[CONFIGURATION] 
TEMPLATEDIR=/QIBM/UserData/OnDemand/WWW/SAMPLES 


[SECURITY] 


The SECURITY section contains the security parameters that are used by ODWEK 
on the Web server. 


This section has a global scope, and you specify it only once in the ARSWWW.INI 
file. 


This section is optional. 


This section can contain the following parameters: 


REPORTSERVERTIMEOUT 

Use to specify that ODWEK should use the Inactivity Time Out parameter from 
the OnDemand server. The Inactivity Time Out parameter determines when a 
server can terminate a session with an inactive user. To specify that ODWEK 
should use the Inactivity Time Out parameter, set the REPORTSERVERTIMEOUT 
parameter to 1 (one). 


This parameter has a global scope, and you specify it only once in the SECURITY 
section. 


This parameter is optional. If you do not specify the REPORTSERVERTIMEOUT 
parameter, then ODWEK will not use the Inactivity Time Out parameter, meaning 
that ODWEK will not terminate a session with an inactive user. For more 
information about the Inactivity Time Out parameter, see the online help for the 
administrative client. 


Example: 


[SECURITY] 
REPORTSERVERT IMEOUT=1 


SERVERACCESS 

Specifies a comma separated list of the OnDemand servers that ODWEK can 
access. If you specify the SERVERACCESS parameter, then the clients that use 
ODWEK and the programs that use the APIs are permitted to access only those 
servers that you specify. You can specify the TCP/IP address, host name alias, or 
fully qualified host name of the server. 
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This parameter has a global scope, and you specify it only once in the SECURITY 
section. 


This parameter is optional. 


Example: 


[SECURITY] 
SERVERACCESS=dave, gunnar 


[AFP2HTML] 


The AFP2HTML section contains the parameters that are used by the AFP2WEB 
Transform. The AFP2WEB Transform converts AFP documents and resources into 
HTML documents that can be displayed with the AFP2HTML applet. 


Notes: 

1. To convert AFP documents to HTML documents, an administrator must obtain 
the AFP2WEB Transform service offering from IBM and install and configure it 
on the server. See your IBM representative for more information about the 
AFP2WEB Transform service offering. Someone in your organization must also 
provide configuration options for the AFP2WEB Transform. See [Appendix A] 
fon mors inforination abcut te 
configuration file. 

2. To convert documents with the AFP2WEB Transform, you must specify the 
AFPVIEWING=HTML parameter in the DEFAULT BROWSER section (or other 
browser sections). See for details. (If you plan to 
use the Retrieve Document APL then you should specify the _afp=HTML 
parameter. See for details.) 

3. By default, ODWEK uses the AFP2HTML applet to view converted documents. 
If a converted document was stored in OnDemand as a large object, then the 


AFP2HTML applet provides controls to help users easily move to any page in 
the document. 


This section has a global scope, and you specify it only once in the ARSWWW.INI 
file. 


This section is optional. 


This section can contain the following parameters: 


CONFIGFILE 
The configuration file that contains the options used by the AFP2WEB Transform 
to convert AFP documents and resources into HTML data, fonts, and images that 


can be viewed with the AFP2HTML applet. |Appendix A, “AFP to HTML 


transform” on page 43}shows the sample configuration file provided with 
OnDemand. See the AFP2WEB Transform documentation for details about the 
options that you can specify in the configuration file. 


This parameter has a global scope, and you specify it only once in the AFP2HTML 
section. 


This parameter is optional. 
Example: 


[AFP2HTML] 
CONFIGFILE=afp2html.ini 
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INSTALLDIR 
The directory that contains the AFP2WEB Transform programs, configuration files, 
and mapping files. Specify the full path name of the directory on the Web server. 


Note: Verify the permissions of the directory that you specify. The processes that 
run ODWEK programs must read the install directory. 


This parameter has a global scope, and you specify it only once in the AFP2HTML 
section. 


This parameter is optional. 


Example: 


[AFP2HTML ] 
INSTALLDIR=/QIBM/UserData/OnDemand/www/bin 


USEEXECUTABLE 
Determines whether ODWEK starts the AFP2WEB Transform by using the shared 
library (DLL) or the executable (EXE). 


Important: ODWEK on the iSeries must use the executable. Therefore, this 
parameter must always be set to 1 (one). 


This parameter has a global scope, and you specify it only once in the AFP2HTML 
section. 


This parameter is optional. 


Example: 


[AFP2HTML] 
USEEXECUTABLE=1 


[AFP2PDF] 


The AFP2PDF section contains the parameters that are used by the IBM AFP2PDF 
Transform. The AFP2PDF Transform converts AFP documents and resources into 
PDF documents that can be viewed with the Adobe Acrobat viewer. 


Notes: 

1. To convert AFP documents to PDF documents, an administrator must obtain 
the AFP2PDF Transform service offering from IBM and install and configure it 
on the Web server. See your IBM representative for more information about the 
AFP2PDF Transform service offering. Someone in your organization must also 
provide configuration options for the AFP2PDF Transform. See[Appendix B] 
AFP to PDF transform” on page 47|for more information about the 
configuration file. 

2. To convert documents with the AFP2PDF Transform, you must specify the 


AFPVIEWING=PDF parameter in the DEFAULT BROWSER (or other browser 
sections). See |“ AFPVIEWING’” on page 27|for details. (If you plan to use the 


Retrieve Document APL then you should specify the _afp=PDF parameter. See 
“Retrieve Document” on page 63]for details.) 

3. By default, ODWEK uses the Adobe Acrobat viewer to view converted 
documents. You must obtain the viewer for the browsers used in your 


organization. 
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This section has a global scope, and you specify it only once in the ARSWWW.INI 
file. 


This section is optional. 


This section can contain the following parameters: 


CONFIGFILE 
The configuration file that contains the options used by the AFP2PDF Transform to 
convert AFP documents and resources into PDF documents that can be viewed 


with the Adobe Acrobat viewer.|Appendix B, “AFP to PDF transform” on page 47 


shows the sample configuration file provided with OnDemand. See the AFP2PDF 
Transform documentation for details about the options that you can specify in the 
configuration file. 


This parameter has a global scope, and you specify it only once in the AFP2PDF 
section. 


This parameter is optional. 


Example: 


[AFP2PDF] 
CONFIGFILE=afp2pdf.ini 


INSTALLDIR 


The directory that contains the AFP2PDF Transform programs, configuration files, 
and mapping files. Specify the full path name of the directory on the Web server. 


Note: Verify the permissions of the directory that you specify. The processes that 
run ODWEK programs must read the install directory. 


This parameter has a global scope, and you specify it only once in the AFP2PDF 
section. 


This parameter is optional. 


Example: 


[AFP2PDF] 
INSTALLDIR=/QIBM/UserData/OnDemand/www/bin 


USEEXECUTABLE 
Determines whether ODWEK starts the AFP2WEB Transform by using the shared 


library (DLL) or the executable (EXE). 


Important: ODWEK on the iSeries must use the executable. Therefore, this 
parameter must always be set to 1 (one). 


This parameter has a global scope, and you specify it only once in the AFP2PDF 
section. 


This parameter is optional. 
Example: 


[AFP2PDF] 
USEEXECUTABLE=1 
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[MIMETYPES] 


The MIMETYPES section identifies the Multipurpose Internet Mail Extension 
(MIME) content type for documents that will be retrieved from the OnDemand 
server. The browser uses the MIME content type to format and display the 
document, to choose the correct applet or viewer to open the document, or to start 
a user-defined program to open the document. 


Notes: 


1. The MIMETYPES section should contain a parameter=value pair for each type of 
document that you plan to retrieve from the OnDemand server. The parameter 
identifies the data type of the document in OnDemand. (This is the data type 
that is assigned to the OnDemand application on the View Information page.) 
The value determines the program that is started to open the document. The 
value is case sensitive. 


2. In the example ARSWWWAINI file (see “Example ARSWWW.INI file” on! 


page 33), the MIMETYPES section contains a parameter for each of the standard 
data types supported by OnDemand (AFP, BMP, EMAIL, GIF, JFIF, LINE, PCX, 
PDF, and TIFF). 


3. In addition to the standard data types, OnDemand also supports user-defined 
data types. A user-defined data type can identify any other type of data that 
you want to store on the system. Before users can view documents that have a 
user-defined data type, you must add a parameter to the MIMETYPE section. 
The parameter must identify the MIME content type of the data and the file 
extension that was specified for the OnDemand application on the View 
Information page. The file extension must also be registered with the operating 
system on the client. For example, suppose you define an application to store 
Lotus” WordPro documents in OnDemand. You specify the file extension as 
LWP on the application View Information page. To configure the system to 
recognize documents retrieved from the application, add the following 
parameter to ARSWWW ANI file: 


[MIMETYPES] 
LWP=application/vnd.lotus-wordpro 


Then, when a user retrieves a document from the application, ODWEK sets the 
MIME content type to application/vnd.lotus-wordpro and the system starts 
Lotus WordPro to open the document. For Netscape, the MIME content type 
must be defined in Preferences->Navigator->A pplications. 


Table 1) lists the MIME content types for several PC applications: 


Table 1. MIME content types for several PC applications 


Lotus Applications WkK1=application/vnd.lotus-1-2-3 
WK3=application/vnd.lotus-1-2-3 
Wk4=application/vnd.lotus-1-2-3 
123=application/vnd.lotus-1-2-3 
APR-application/vnd.lotus-approach 
VEW=application/vnd.lotus-approach 
LWP =application/vnd.lotus-wordpro 
SAM=application/vnd.lotus-wordpro 
MWPz=application/vnd.lotus-wordpro 
SMM =application/vnd.lotus-wordpro 
PRE=application/vnd.lotus-freelance 


PRZ=application/vnd.lotus-freelance 
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Table 1. MIME content types for several PC applications (continued) 


Microsoft Applications DOC=application/msword 
XLS=application/vnd.ms-excel 
PPS=application/vnd.ms-powerpoint 
PPT=application/vnd.ms-powerpoint 
MPD=application/vnd.ms-project 
MPP=application/vnd.ms-project 
MPT=application/vnd.ms-project 
MPD=application/vnd.ms-project 


HTML Applications HTML<=application/html 
HTM =application/htm 


This section has a global scope, and you specify it only once in the ARSWWW.INI 
file. 


This section is optional. 


This section can contain the following parameters: 


AFP 
The MIME content type for AFP documents, when AFPVIEWING=NATIVE is 
specified in the [DEFAULT BROWSER] section. See [/AFPVIEWING’” on page 27] for 
more information. This specifies the MIME type for the document that the browser 
then uses to determine what program should be used process the document. 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. 


Example: 


[MIMETYPES] 
AFP=application/afp 


BMP 
The MIME content type for BMP documents. By default, BMP documents are 
displayed using the Image Web Viewer. 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. However, if you do not specify this parameter, then 
ODWEK sets the MIME content type to image/bmp and starts the program that is 
associated with the BMP file type on the client operating system. 


Example: 


[MIMETYPES] 
BMP=image/IBM-OnDemand 


GIF 
The MIME content type for GIF documents. By default, GIF documents are 
displayed using the Image Web Viewer. 


Chapter 2. Installing and configuring the Web server 21 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. However, if you do not specify this parameter, then 
ODWEK sets the MIME content type to image/gif and uses the browser’s built-in 
viewer to display GIF documents. 


Example: 


[MIMETYPES] 
GIF=image/IBM-OnDemand 


EMAIL 
The MIME content type for EMAIL documents. See |“EMAILVIEWING” on page 28 


for more information about processing EMAIL documents before sending them to 
the client. 


Notes: 

1. If you convert EMAIL documents to HTML, ODWEK sets the MIME content 
type to text/html. ODWEK ignores the value of the EMAIL parameter, if 
specified. 

2. If you extract and uncompress EMAIL documents from OnDemand, ODWEK 
uses the value of the EMAIL parameter to determine the program to open the 
document. 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. 


Example: 


[MIMETYPES] 
EMAIL=text/plain 


JFIF 
The MIME content type for JFIF (JPEG) documents. By default, JFIF documents are 
displayed using the Image Web Viewer. 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. However, if you do not specify this parameter, then 
ODWEK sets the MIME content type to image/jpeg and starts the program that is 
associated with the JPEG file type on the client operating system. 


Example: 


[MIMETYPES] 
JFIF=image/IBM-OnDemand 


LINE 
The MIME content type for line data documents. See|“ LINEVIEWING” on page 29 


for more information about processing line data documents before sending them to 
the client. 


This is used when LINEVIEWING=NATIVE is specified in the [DEFAULT 
BROWSER] section. If you extract and uncompress line data documents from 
OnDemand, ODWEK uses the value of the LINE parameter to determine the 
program to start to open the document. 
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This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. 


Example: 


[MIMETYPES] 
LINE=text/html 


PCX 
The MIME content type for PCX documents. By default, PCX documents are 
displayed using the Image Web Viewer. 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. However, if you do not specify this parameter, then 
ODWEK sets the MIME content type to image/pcx and starts the program that is 
associated with the PCX file type on the client operating system. 


Example: 


[MIMTYPES] 
PCX=image/IBM-OnDemand 


PDF 
The MIME content type for PDF documents. 
Notes: 


1. ODWEK uses the value of the PDF parameter to determine the program to 
start to open PDF documents. By default, PDF documents are opened with the 
Adobe Acrobat viewer. 

2. To view PDF documents, you should obtain and install the Adobe Acrobat 
viewer for the browsers used by your organization. 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. 


Example: 


[MIMETYPES] 
PDF=application/pdf 


TIFF 
The MIME content type for TIFF documents. By default, TIFF documents are 
displayed using the Image Web Viewer. 


This parameter has a global scope, and you specify it only once in the 
MIMETYPES section. 


This parameter is optional. However, if you do not specify this parameter, then 
ODWEK sets the MIME content type to image/tiff and starts the program that is 
associated with the TIFF file type on the client operating system. 


Example: 
[MIMETYPES] 
TIFF=image/IBM-OnDemand 
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[ATTACHMENT IMAGES] 


The ATTACHMENT IMAGES section identifies the image files that ODWEK uses 
to display attachments to a document. Each image file should contain an icon that 
represents a specific type of attachment. For example, you can identify an image 
file that contains an icon for a text attachment, a bitmap attachment, and so forth. 


Notes: 

1. Each parameter that you specify must identify the file type that the operating 
system associates with the type of attachment. The file type determines the 
program that the operating system starts to process the attachment. For 
example, if the operating system associates the file type TXT with text file 
attachments, add a TXT=value parameter to the ATTACHMENT IMAGES 
section. As the value, specify the name of the file that contains the icon that you 
want to use to indicate a text attachment to a document. When the user clicks 
on the icon, the operating system starts the program that is registered to open 
TXT documents. 

2. By default, all attachments to a document are indicated by the odic_att.gif 
file (which is located in the directory that is specified by the IMAGEDIR 
parameter in the CONFIGURATION section). OnDemand also uses the 
odic_att.gif file for any file types for which a parameter is not specified in the 
ATTACHMENT IMAGES section. 


This section has a global scope, and you specify it only once in the ARSWWW.INI 
file. 


This section is optional. 


This section can contain the following parameters: 


BMP 
The parameter identifies the bitmap data type. The value identifies the file that 
contains the icon to represent a bitmap image attached to the document. 


This parameter has a global scope, and you specify it only once in the 
ATTACHMENT IMAGES section. 


This parameter is optional. 


Example: 


[ATTACHMENT IMAGES] 
BMP=userBitMap.gif 


GIF 
The parameter identifies the GIF data type. The value identifies the file that 
contains the icon to represent a GIF image attached to the document. 


This parameter has a global scope, and you specify it only once in the 
ATTACHMENT IMAGES section. 


This parameter is optional. 
Example: 


[ATTACHMENT IMAGES] 
GIF=userGIF.gif 
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TXT 
The parameter identifies the TXT data type. The value identifies the file that 
contains the icon to represent a text file attached to the document. 


This parameter has a global scope, and you specify it only once in the 
ATTACHMENT IMAGES section. 


This parameter is optional. 


Example: 


[ATTACHMENT IMAGES] 
TXT=userText.gif 


[NO HTML] 


The NO HTML section contains the parameters that are used to override the 
default characters that delimit strings and separate a list of values in the delimited 


ASCII output. A function generates delimited ASCII output when you set its 
_nohtm] parameter to 1 (one). See|Appendix G, “No HTML output” on page 83} for 


details about the delimited ASCII output. 


This section has a global scope, and you specify it only once in the ARSWWW.INI 
file. 


This section is optional. 


This section can contain the following parameters: 


BEGIN 
The character that ODWEK uses to delimit the beginning of a string or a string of 


values. You must change the BEGIN delimiter if a string contains the default 
character (the [ character). 


This parameter has a global scope, and you specify it only once in the NO HTML 
section. 


This parameter is optional. 


Example: 


[NO HTML] 
BEGIN=< 


END 

The character that ODWEK uses to delimit the end of a string or a string of values. 
You must change the END delimiter if a string contains the default character (the ] 
character). 


This parameter has a global scope, and you specify it only once in the NO HTML 
section. 


This parameter is optional. 
Example: 


[NO HTML] 
END=> 
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SEPARATOR 


The character that ODWEK uses to separate a string of values. You must change 
the SEPARATOR delimiter if a string contains the default character (the acharacter 


). 


This parameter has a global scope, and you specify it only once in the NO HTML 
section. 


This parameter is optional. 


Example: 


[NO HTML] 
SEPARATOR=; 


[DEFAULT BROWSER] 


You can use the DEFAULT BROWSER section to specify parameters for the 
browsers used by your organization. The parameters that you specify will be used 
unless you specify them in a browser section. (The parameters specified in a 
browser section override those from the DEFAULT BROWSER section.) 


This section has a global scope for all browsers, and you specify it only once in the 
ARSWWWALINI file. 


This section is optional. 


This section can contain the following parameters: 


ADDEXTENSION 

Determines whether the three-character file extension of the document is added to 
the extra path information of the URL that is returned to the browser. Adding the 
file extension to the URL can help browsers determine the correct viewer to start 
for the document. The default value is 0 (zero) and means that the file extension is 
not added to the URL. 


Note: If you use the Microsoft Internet Explorer browser, then IBM recommends 
that you specify ADDEXTENSION=1 so that the file extension is added to 
the URL. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
ADDEXTENSION=1 


ADDFIELDSTODOCID 

Determines whether the field values are added to the document identifiers. (The 
document identifiers are returned by the Document Hit List function.) The default 
value is 0 (zero) and means that the field values are not added to the document 
identifiers. If you enable ODWEK to add the field values to the document 
identifiers, then they will also appear in the system log, provided that you have 
configured the system to save application group messages in the system log. 
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Notes: 


1. If you use the Update Document function, then you must specify 
ADDFIELDSTODOCID=1. 


2. If the Annotation Flags in the document database table field is set to Yes, 
then you must specify ADDFIELDSTODOCID=1. You can set the Annotations 
Flags in document database table field on the Database Information dialog 
box, from the General page in the OnDemand application group definitions. 
(Click Advanced to open the Database Information dialog box.) 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
ADDFIELDSTODOCID=1 


ADDNOTES 


Determines whether annotations can be added to documents. If enabled, ODWEK 
puts a control for adding annotations next to each document in the document list. 
The default value is 0 (zero) and means that annotations cannot be added to 
documents. 


Note: Users are permitted or denied the ability to add annotations to documents 
based on the Annotation permissions in the OnDemand application group. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
ADDNOTES=1 


AFPVIEWING 

When a user retrieves an AFP document from the OnDemand server, the value of 
this parameter determines what action, if any, ODWEK takes before sending the 
document to the client. For example, some customers convert AFP documents to 
HTML with the AFP2WEB Transform and use the AFP2HTML applet to view the 
HTML output. Those customers should specify AFPVIEWING=HTML so that 
ODWEK will convert the AFP document before sending it to the client. 


You can set the parameter to one of the following values: 


ASCII ODWEK converts AFP documents to ASCII text. 

HTML ODWEK converts AFP documents to HTML documents with the 
AFP2WEB Transform. 

NATIVE ODWEK extracts and uncompresses AFP documents and their 


resources from OnDemand. 


Note: If you specify AFPVIEWING=NATIVE, verify that the MIME 
content type for AFP documents identifies the viewer that 


you want to use. See |“[MIMETYPES]” on page 20) for details. 
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PDF ODWEK converts AFP documents to PDF documents with the 
AFP2WEB Transform. 


Note: If you specify AFPVIEWING=PDE, verify that the MIME 
content type for PDF documents identifies the viewer that 
you want to use. See|“[MIMETYPES]” on page 20} for details. 


PLUGIN ODWEK does not convert AFP documents (the default). 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. When using the Retrieve Document function, you can override 
the specified action with the _afp parameter. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
AFPVIEWING=PLUGIN 


AUTODOCRETRIEVAL 

Specifies whether the client automatically displays a document when one and only 
one document matches the query. This capability means that, for queries that you 
know will match only one document, you can set up the system to bypass the 
document list Web page and display the document without the user taking action. 
The default value is 0 (zero) and means that ODWEK will display the document 
list Web page, even if only one document matches the query. 


Important: Do not enable automatic document retrieval if you plan to use the 
Microsoft Internet Explorer browser. IBM suggests that you specify 
AUTODOCRETRIEVAL=0 in any browser sections that you define for 
Internet Explorer. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
AUTODOCRETRIEVAL=1 


EMAILVIEWING 


When a user retrieves an EMAIL document from the OnDemand server, the value 
of this parameter determines what action, if any, ODWEK takes before sending the 
document to the client. 


You can set this parameter to one of the following values: 


NATIVE ODWEK extracts and uncompresses EMAIL documents from 
OnDemand. 


Note: If you specify EMAIL=NATIVE, verify that the MIME 
content type identifies the viewer that you want to use. See 
“[MIMETYPES]” on page 20] for details. 
HTML ODWEK converts EMAIL documents to HTML documents. This is 
the default value. 
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This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. When using the Retrieve Document function, you can override 
the specified action with the _email parameter. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
EMAILVIEWING=HTML 


ENCRYPTCOOKIES 

Determines whether ODWEK encrypts cookies that are sent to the browser. The 
default value is 0 (zero), meaning that cookies will not be encrypted. Specify 1 
(one) to encrypt all cookies that are sent to the browser. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
ENCRYPTCOOKIES=1 


ENCRYPTURL 

Determines whether ODWEK encrypts the server, userid, password, and docid 
values that are contained in the URL that is sent to the browser. The default value 
is 0 (zero), meaning that these values will not be encrypted. Specify 1 (one) to 
encrypt these values. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. However, if you must use the GET method to transfer 


form parameters and values between the browser and the Web server, then you 
can encrypt these values by specifying ENCRYPTURL=1. See 
ood’ on pest more information about the method attribute of the form 
tag. 


Example: 


[DEFAULT BROWSER] 
ENCRYPTURL=1 


LINEVIEWING 

When a user retrieves a line data document from the OnDemand server, the value 
of this parameter determines what action, if any, ODWEK takes before sending the 
document to the client. 


You can set this parameter to one of the following values: 


APPLET ODWEK converts line data documents for viewing with the Line 
Data applet (the default). 

ASCII ODWEK converts line data documents to ASCII text. 

NATIVE ODWEK extracts and uncompresses line data documents from 
OnDemand. 
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Note: If you specify LINEVIEWING=NATIVE, verify that the 
MIME content type identifies the viewer that you want to 
use. See |“[MIMETYPES]” on page 20}for details. 
This parameter has a global scope, and you specify it only once in the DEFAULT 


BROWSER section. When using the Retrieve Document function, you can override 
the specified action with the _line parameter. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
LINEVIEWING=APPLET 


MAXHITS 
The maximum number of items returned to the document list, regardless of the 
number of items that match the query. 


Notes: 


1. The document list is filled with items that match a query in the order in which 
the items were loaded into the database. 

2. ODWEK uses the first value specified to determine the number of items to 
return to the document list: 

a. For the Document Hit List function, the value of the Maximum Hits field 
(specified on the folder Permissions page). This value overrides all other 
values. 

b. For the Document Hit List and Print Document functions, the value of the 
_max_hits parameter, if specified for a function. The value of the _max_hits 
parameter overrides the MAXHITS parameter. 

c. The value of the MAXHITS parameter, if specified. 


d. If none of the above are specified, ODWEK returns a maximum of 200 items 
to the document list. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
MAXHITS=200 


NOLINKS 

Determines whether the document list contains controls for viewing documents. If 
enabled, ODWEK adds a control next to each document. To view a document, the 
user must use the control. The default value is 0 (zero) and means that the user 
must use a text link to view a document. 


Important: You must set NOLINKS=0 if you are using the Microsoft Internet 
Explorer browser. IBM suggests that you specify NOLINKS=0 in any 


browser sections that you define for Internet Explorer. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 
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This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
NOLINKS=1 


SERVERPRINT 

Determines whether the document list contains controls for sending documents to 
a server printer. If enabled, ODWEK adds a control next to each document. The 
default value is 0 (zero) and means that users must open a document before they 
can send it to a server printer. 


Notes: 


1. To use server print, at least one server printer must be defined to the 
OnDemand server. 


2. Users are permitted or denied the ability to print documents based on the Print 
permissions in the OnDemand application group. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
SERVERPRINT=1 


SERVERPRINTERS 
Use to specify the type of server print devices that the user can select. There are 
three types of server print devices: 


P Server Printer 
I Server Printer with Information 
F Server Fax 


You can specify from zero to three types, in a comma-separated list. 


The following example shows how to specify that the user can select server printer 
and server fax devices: 


[DEFAULT BROWSER] 
SERVERPRINTERS=P, F 


SHOWDOCLOCATION 

When generating delimited ASCII output rather than HTML (see[Appendix G, “No| 
ATMEL output” on page 83), determines whether the storage location of the 
document will appear in the output. See ‘Document Hit List” on page 85)for 


details. The default value is 0 (zero) and means that the storage location will not 
appear in the output. 


Note: To display the storage location, you must also set the Display Document 
Location property in the OnDemand folder. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 
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Example: 


[DEFAULT BROWSER] 
SHOWDOCLOCATION=1 


VIEWNOTES 

Determines whether annotations to documents can be viewed. If enabled, ODWEK 
puts a control for viewing annotations next to each document in the document list. 
The default value is 0 (zero) and means that annotations cannot be viewed. 


Note: Users are permitted or denied the ability to view annotations to documents 
based on the Annotation permissions in the OnDemand application group. 


This parameter has a global scope, and you specify it only once in the DEFAULT 
BROWSER section. 


This parameter is optional. 


Example: 


[DEFAULT BROWSER] 
VIEWNOTES=1 


[browser] 


You can specify options for the specific browsers used by your organization. The 
parameters that you specify in a browser section override the parameters from the 
DEFAULT BROWSER section of the ARSWWWA.INI file. (The parameters that you 
specify in the DEFAULT BROWSER section will be used unless you specify them 
in a browser section.) 

Notes: 


1. The section header must contain a string that identifies the browser for which 
you want to specify the options. ODWEK extracts the value of the 
HTTP_USER_AGENT environment variable to determine the browser being 
used. ODWEK then searches the ARSWWW.INI file for a browser section that 
matches the value. If no browser section is found, ODWEK then searches the 
ARSWWWALINI file for one of the following sections: 


[browser version(major.minor) /platform] 
[browser version(major.minor) ] 

[browser version(major) ] 

[browser] 


[DEFAULT BROWSER] 


ODWEK uses the options from the first section that matches the value. 
2. For the browser, you can specify IE or Netscape. 
3. For the platform, you can specify Win95, Win98, WinNT, or Unix. 
A browser section has a global scope for the specified browser. Specify only one 
browser section for each browser. You should specify only the parameters that you 
need to override from the DEFAULT BROWSER section. 


This section is optional. 
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This section can contain the same parameters that are defined for the default 
browser. See |“[DEFAULT BROWSER]” on page 26 
Examples: 


[IE 5] 
AUTODOCRETRIEVAL=0 
NOLINKS=0 


[Netscape 4.6] 
AUTODOCRETRIEVAL=1 
NOLINKS=1 


[DEBUG] 


The DEBUG section contains options that you can use to help solve problems that 
you and others in your organization are having using ODWEK. 


The DEBUG section has a global scope, and you specify it only once in the 
ARSWWWALINI file. 


This section is optional. 


This section can contain the following parameters: 


LOG 


Enables ODWEK to write messages and other program information to a log file. 
(The log file is named ARSWWW.LOG.) 


This parameter has a global scope, and you specify it only once in the DEBUG 
section. 


This parameter is optional. By default, ODWEK does not write messages to a log 
file. Specify a value of 1 (one) to log messages. 


Example: 


[DEBUG] 
LOG=1 


LOGDIR 
Determines the directory in which ODWEK writes the ARSWWW.LOG file, if 
logging is enabled using the LOG parameter. 


This parameter has a global scope, and you specify it only once in the DEBUG 
section. 


This parameter is optional. By default, if logging is enabled, ODWEK writes the 
log file to the /QIBM/UserData/OnDemand/WWW/LOG directory. 


Example: 


[DEBUG] 
LOGDIR=/QIBM/UserData/OnDemand/WWW/LOG 


Example ARSWWW.INI file 


An example ARSWWW.INI configuration file is provided with the product. The 
example configuration file sets the most commonly used default values for servers, 
browsers (Netscape Navigator), and viewers. 
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PSIPISFSIIIVIAOVISIIP VIF T9999 9 
333 Server Configuration 333 


9999999999999999999999999999399 


[@SRV@_<host alias>]; 
HOST=<host name>; 
PORT= 3 

PROTOCOL= ; 


[@SRV@_myiSeries.mycompany.com] 
HOST=myiSeries.mycompany.com 
PORT=1450 

PROTOCOL=0 


[CONFIGURATION] 

CodePage=37 

Language=ENU 

TemplateDi r=/QIBM/UserData/OnDemand/www/SAMPLES 
ImageDir=/IMAGES/ 

AppletDir=/applets/ 

CacheDi r=/QIBM/UserData/OnDemand/www/ 
CacheSize=0 

CacheMinThreshold=0 
CacheMaxThreshold=0 

CacheDocs=0 

CacheUserIDs=web, demo,mstephens 


[SECURITY] 
SERVERACCESS= 


[AFP2HTML] 

Instal1Dir=/QIBM/UserData/OnDemand/www/bin 
ConfigFile=/QIBM/UserData/OnDemand/www/bin/afp2html .ini 
UseExecutable=1 


[AFP2PDF] 

Instal1Dir=/QIBM/UserData/OnDemand/www/bin 
ConfigFile=/QIBM/UserData/OnDemand/www/bin/afp2pdf.ini 
UseExecutable=1 


[MIMETYPES] 
BMP=image/1IBM_OnDemand 
GIF=image/IBM_OnDemand 
JFIF=image/1BM_OnDemand 
PCX=image/IBM_OnDemand 
TIFF=image/1BM_OnDemand 
PNG=image/IBM_ OnDemand 
PDF=application/pdf 
AFP=application/afp 
LINE=application/line 
EMAIL=text/html 
META=application/unknown 


[ATTACHMENT IMAGES] 
TXT=userText.gif 
BMP=userBitMap.gif 
GIF=userGIF.gif 


[NO HTML] 
BEGIN=[ 
END=] 
SEPARATOR=A 


PSPSPS ISIVIFSIDSIIII 9999999 
333; Default Browser o33 


99999999999999999999959999 
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[DEFAULT BROWSER] 


sAfpViewing=[ascii, html native, pdf,plugin, xenos] 
AfpViewing=plugin 
;LineViewing=[ascii,applet,native] 
LineViewing=applet 
3EmailViewing=[html ,native] 
EmailViewing=htm] 
;MetaViewing=[xenos, native] 
MetaViewing=native 

NoLinks=1 

ViewNotes=1 

AddNotes=1 

ServerPrint=1 

ServerPrinters=P 
AutoDocRetrieval=1 

MaxHits=200 

ShowDocLocation=1 


[IE] 

NoLinks=0 
AddExtension=1 
AddFieldsToDocid=0 


[Mozilla/4.0 (compatible; MSIE 4.0; Windows 95)] 
[Netscape 3.01] 


[DEBUG] 
3log=1 
3 logdir=/QIBM/UserData/OnDemand/www/1logs 


Your next step 


After you have installed the ODWEK software and configured _the ARSWWW.INI 
file, you should now configure the sample applications. See 
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Chapter 3. Configuring the sample applications 


This chapter explains how to customize the sample applications that are provided 
with ODWEK: 


* LOGON.HITM. This application supports users that are permitted to access 
several folders. Each user is defined to the OnDemand server. After logging on 
to the server, ODWEK shows the user the list of folders that the user is 
permitted to open. 


* CREDIT.HTM. This application supports casual use of OnDemand. The user is 
presented with search criteria for a specific folder. The OnDemand server name, 


userid and password, folder name, and folder fields are coded in the application. 
“CREDIT.HTM”| contains instructions for customizing this application. 

* FCREDIT.HTM. A version of the CREDIT application that demonstrates the use 
of HTML frames. 


After you modify the sample applications, publish the URL of each file so that 
users can link to them and access OnDemand. Each sample requires a different 
level of customization. There are complete instructions for customizing one of the 
sample applications. Use the instructions as a guide for customizing other 
applications that you may need. 


Note: In addition to modifying the sample applications, IBM recommends that you 
customize the TEMPLATE.HTM file for your organization. The 
TEMPLATE.HTM file contains user-defined content that ODWEK uses to 
display Web pages. See [“TEMPLATE.HTM” on page 38]for important 
information about modifying this file. 


CREDIT.HTM 


Customize the CREDIT.HTM sample application by making a copy of the file for 
each folder that you want users to access. The name of the file should be the same 
as the name of the folder. 
1. Edit the CREDIT.HTM file. (By default, this file is located in the 
/QIBM/UserData/OnDemand/WWW/SAMPLES directory.) 
2. Change or delete the background image specified in the <body> statement 
(line 11). 
3. Optionally change the background color specified in the <body> statement 
(line 11). 
4. Change or delete the product image specified in the <img> statement (line 12). 


oO 


Replace the folder name specified in the <h1> statement (line 15). 


6. Replace the text specified in the <p> statements (lines 17 through 25). Enter 
general instructions to the user. 


7. Replace the CGI-BIN directory name specified in the <FORM> statement (line 
29). Enter the name of the CGI-BIN directory that contains the ODWEK 
programs and files on the Web server. 


8. Replace the value specified in the <input> statement (line 30). This is a 
comma separated string that contains the names of the folder display fields. 


9. Replace the value specified in the <input> statement (line 31). This is the 
name of the folder. 
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10. Replace the value specified in the <input> statement (line 33). This is the 
maximum number of items displayed in the document list, regardless of the 
number of items that match the query. 

11. Replace the server name specified in the <input> statement (line 35). This is 
the name of the OnDemand server with which ODWEK is to communicate. 
The supplied server name is gunnar. 

12. If you want to sort items in the document list, verify the value specified in the 
<input> statement (line 36). Otherwise, delete line 36. 

13. If you want to sort items in the document list, verify the value specified in the 
<input> statement (line 37). Otherwise, delete line 37. 

14. Replace the value specified in the <input> statement (line 38). This is the 
OnDemand userid. The userid that you specify must have permission to open 
the folder and access application group data. 

15. Optionally change the name of the template file specified in the <input> 
statement (line 39). OnDemand uses the template file to generate subsequent 
Web pages. The supplied template name is template.htm. 

16. Modify lines 40 through 43 for the first folder search field. 

a. Type a name for the folder field in the <font> statement. 


b. Replace the value specified in the name field of the <input> statement 
with the actual folder field name. 
c. Replace the value specified in the value field of the <input> statement 
with the default search value. 
17. Copy lines 40 through 43 and repeat step [16] for each additional folder search 
field. 


18. Save your changes and close the text editor. 


TEMPLATE.HTM 


The TEMPLATE.HTM file is the default template file used by ODWEK to generate 
Web pages in response to the various product functions (such as Logon). You 
should replace this file with one that contains user-defined content. However, the 
template file must contain the following HTML comment line: 


<!- - - AOI# Marker - - -> 


The location of comment line determines where ODWEK program places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written after the 
output generated by ODWEK. 


By default, the template file is located in the directory named by the 
TEMPLATEDIR parameter in the ARSWWW.INI file. See |“TEMPLATEDIR” on 


for details. 


Your next step 
After you have installed the ODWEK software, configured the ARSWWWLINI file, 


and configured the sample applications, you should now install the Web viewers 
on the user workstations. See|Chapter 4, “Installing the Web viewers” on page 39 
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Chapter 4. Installing the Web viewers 


Overview 


IBM provides viewers for the standard types of documents that can be retrieved 
from OnDemand. The installation requirements vary, depending on the viewers 
that the people in your organization need to use. 


To view line data documents, IBM recommends that you use the Line Data 
applet. The Line Data applet is stored on the Web server. After you enable the 
use of the Line Data applet, it is automatically loaded into memory on the 
workstation when the user selects to view a line data document. Verify that the 
LINEVIEWING parameter in the ARSWWW.INI file specifies the viewer that 
your users will be using. 


To view AFP documents, you can use the IBM OnDemand AFP Web Viewer, the 
AFP2HTML applet, or the Adobe Acrobat viewer. 


— To view AFP documents with the IBM OnDemand AFP Web Viewer, users 
must install it on their workstations. 


— To view AFP documents with the AFP2HTML applet, an administrator must 
install and configure the AFP2WEB Transform on the Web server and 
configure the ARSWWWLINI file. The AFP2HTML applet is stored on the Web 
server. After an administrator enables the use of the AFP2HTML applet, it is 
automatically loaded into memory on the workstation when the user selects 
to view an AFP document. 


— To view AFP documents with the Adobe Acrobat viewer, an administrator 
must install and configure the AFP2PDF Transform on the Web server and 
configure the ARSWWWALINI file. After an administrator enables the use of the 
transform, by default, the browser will attempt to start the Adobe Acrobat 
viewer when the user selects to view an AFP document. The user must obtain 
and install the Adobe Acrobat viewer on the workstation. 


Verify that the AFPVIEWING parameter in the ARSWWWLINI file specifies the 
viewer that your users will be using. 


To view BMP, GIF, JPEG, PCX, and TIFF documents, IBM recommends that your 
users install the IBM OnDemand Image Web Viewer on their workstations; 
otherwise, they should use some other viewer that handles these types of 
documents. (For example, most browsers have built-in viewers capable of 
viewing GIF and JPEG.) If your users decide to use some other viewer, make 
sure that an administrator changes the default MIME content type for these 
types of documents. Verify that the parameters in the MIMETYPES section of the 
ARSWWWAINI file specify the viewers that your users will be using. 


Notes: 


1. 


To view other types of data, you may need to install other viewers. For 
example, to view PDF documents that are retrieved from the OnDemand 
server, IBM recommends that you obtain and install the Adobe Acrobat viewer 
for the browsers used in your organization. 


The nppdf32.d11 file is required in the browser plugin directory to view PDF 
documents. For Internet Explorer, it should be in the \Program Files\Internet 
Explorer\PLUGINS directory. For Netscape, it should be in the \Program 
Files\Netscape\Communicator\Program\Plugins directory. If the file is not in the 
browser directory, you will need to reinstall the Adobe software. 
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Requirements 


The viewers that are provided by IBM require Netscape Navigator 4.06 or later or 
Microsoft Internet Explorer 4.01 or later. 


ODWEK requires the ability to write cookie data on the client. Make sure that your 
users configure their browsers to accept cookies. 


The applets that are provided by IBM require Java support in the browser. Java 
support is most likely provided by a Java Virtual Machine (JVM). If you are using 
Microsoft Internet Explorer Version 5.5, then when you install the browser, you 
must use the Custom installation option to select and install the JVM. 


The browser must run under Windows® 2000, Windows 98, Windows NT® 4.0 with 
SP5 or later, or Windows XP and requires the following hardware and software: 


* Physical connection to the network, such as a Token Ring or Ethernet network 
adapter 


= TCE 

¢* A minimum of 32 MB of RAM 

* An IBM-compatible PC with a 166 MHz or faster processor 

* Asuper VGA display and adapter with a minimum resolution of 800 x 600 
* A minimum of 20 MB of free disk space to view documents 


* Approximately 3 MB on each workstation that needs the IBM OnDemand AFP 
Web Viewer and 2 MB on each workstation that needs the IBM OnDemand 
Image Web Viewer. 


Installation 


Note: If you plan to distribute user-defined files with the AFP Web Viewer, then 
you should configure the AFP Web Viewer installation file to hold the 
user-defined files before your users begin installing the AFP Web Viewer. 
See|Appendix D, “Distributing user-defined files” on page 73|for more 
information. 


The viewers that are provided by IBM are installed using self-extracting files. 

These files should be downloaded to the user’s Windows 98, Windows NT, 

Windows 2000, or Windows XP system and run to install the appropriate viewer. If 

the user is running a browser while the installation is in progress, then the user 

must stop and restart the browser before the viewer can be used. The following 

viewer files can be found in the /QIBM/ProdData/OnDemand/www/plugins directory: 

* afpplgus.exe - IBM OnDemand AFP Web Viewer - English only 

* afpplgin.exe - IBM OnDemand AFP Web Viewer - All languages including DBCS 
support 

* afpplgin.zip - IBM OnDemand AFP Web Viewer - Zip format for all languages 
include DBCS support 

* imgplgin.exe - IBM OnDemand Image Web Viewer - All languages 


The installation process copies the viewer and its associated files to directories of 
the user’s choice. The AFP Web Viewer requires approximately 3 MB of space on 
the workstation. The Image Web Viewer requires approximately 2 MB of space on 
the workstation. Remind your users to restart their browser if it is active during 
the installation process. 
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Note: The installation program will install the viewers as either plug-ins or 
ActiveX controls. If Internet Explorer is installed on the workstation, then 
the installation program will install the ActiveX controls; if Netscape is 
installed on the workstation, then the installation program will install the 
plug-ins. If you have both Internet Explorer and Netscape installed on the 
workstation, then the installation program will install the ActiveX controls 
for Internet Explorer and the plug-ins for Netscape. 


Your next step 


After you have installed the ODWEK software, configured the ARSWWWLINI file, 
configured the sample applications, and installed the Web viewers, you can now 
begin using ODWEK. 
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Appendix A. AFP to HTML transform 


The AFP to HTML transform process converts AFP documents and resources into 
HTML documents. The AFP to HTML transform process requires the AFP2WEB 
Transform service offering from IBM Printing Systems Division. An administrator 
must install and configure the AFP2WEB Transform on the Web server. See your 
IBM representative for more information about the AFP2WEB Transform service 
offering. Someone in your organization must also specify configuration options for 
the AFP documents and resources that you plan to process with the AFP2WEB 
Transform. This section describes how to specify the configuration options. 


Note: In this document, the name AFP2HTML.INI refers to the configuration file. 
To specify the file that contains the configuration options, see 
“CONFIGFILE” on page 17 


The AFP2HTML.INI file provides configuration options for the AFP2WEB 
Transform. You typically configure the AFP2HTML.INI file with options for specific 
AFP applications. However, you can also provide a set of default options. The 
AFP2WEB Transform uses the default options when converting documents and 
resources for AFP applications that are not identified in the AFP2HTML.INI file. To 
learn more details about the options and the conversion process, see the AFP2WEB 
Transform documentation. 


The following topics provide additional information about the AFP2HTML.INI file: 
* Format of the AFP2HTML.INI file 

* Options for the AFP2WEB Transform 

* Viewing converted documents 


Note: To convert documents with the AFP2HTML applet, you must also specify 
the AFPVIEWING=HTML parameter in the DEFAULT BROWSER section (or 
other browser sections) of the ARSWWWLINI file. Seo /AFP VIEWING ol 
[page 27] for details. (If you plan to use the Retrieve Document API, then you 
should specify the _afp=HTML parameter. See 


[page 63] for details.) You must also specify the directory that contains the 
AFP2WEB Transform programs (see /’CONFIGFILE” on page 17). 
Format of the AFP2HTML.INI file 


The following is an example of an AFP2HTML.INI file: 


[CREDIT-CREDIT] 

UseApp]et=FALSE 

ScaleFactor=1.0 

CreateGIF=TRUE 
SuppressFonts=FALSE 
FontMapFile=creditFontMap.cfg 
ImageMapFile=creditImageMap.cfg 


[default] 

ScaleFactor=1.0 

CreateGI F=TRUE 
SuppressFonts=FALSE 
FontMapFile=fontmap.cfg 
ImageMapFi1le=imagemap.cfg 
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The structure of the file is similar to a Windows INI file, and contains one stanza 
for each AFP application and one default stanza. The title line of the stanza 
identifies the application group and application. For example, the title line: 


[CREDIT-CREDIT] 


Identifies the CREDIT application group and the CREDIT application. Use the — 
(dash) character to separate the names in the title line. The names must match the 
application group and application names defined to the OnDemand server. If the 
application group contains more than one application, then create one stanza for 
each application. 


The options in the [default] stanza are used by the AFP2WEB Transform to 
process documents for AFP applications that are not identified in the 
AFP2HTML.INI file. The defaults are also used if an AFP application stanza does 
not include one of the options. 


The UseApplet option is a directive to ODWEK. It determines whether the 
AFP2HTML applet will be used to view the output from the AFP2WEB Transform. 
The default value is TRUE. If you specify FALSE, (the AFP2HTML applet is not 
used to view the output), then the output is formatted and displayed by the Web 


browser. 

The remaining five options are directives to the AFP2WEB Transform. 
the AFP2WEB Transform”|briefly describes how they are used by the AFP2WEB 
Transform. 


Options for the AFP2WEB Transform 


Table 2}lists the options that you can specify in the AFP2HTML.INI file to convert 
documents with the AFP2WEB Transform. 


Table 2. Options for the AFP2WEB Transform 


Option in AFP2HTML.INI Description 
file 


AllObjects Determines how ODWEK processes documents that are 
stored as large objects in OnDemand. The default value is 0 
(zero), and means that ODWEK will retrieve only the first 
segment of a document. If you specify 1 (one), then 
ODWEK will retrieve all of the segments and convert them 
before sending the document to the client. Note: If you 
enable large object support for very large documents, then 
your users may experience a significant delay before they 
can view the document at the client. 


ScaleFactor Scales the output with the given scale factor. The default 
value is 1.0. For example, specifying a value of 
ScaleFactor=2.0 scales the output to be twice as large as 
the default size; specifying a value of ScaleFactor=0.5 
scales the output to one half of the default size. The default 
size is derived from the Zoom setting on the Logical Views 
page in the OnDemand application. 


SuppressFonts Determines whether the AFP text strings are transformed. If 
you specify SuppressFonts=TRUE, any text that uses a font 
listed in the Font Map file is not transformed. The default 
value is FALSE, which means that all of the AFP text strings 
are transformed. The Font Map file is identified with the 
FontMapFile option 


44 IBM Content Manager OnDemand for iSeries Common Server: Web Enablement Kit Installation and Configuration Guide 


Table 2. Options for the AFP2WEB Transform (continued) 


Option in AFP2HTML.INI 
file 


FontMapFile 


Description 


Identifies the full path name of the Font Map file. The Font 
Map file contains a list of fonts that require special 
processing. The default Font Map file is named 
imagfont.cfg and resides in the directory that contains the 
AFP2WEB Transform programs. See the AFP2WEB 
Transform documentation for details about the Font Map 
file. 


ImageMapFile 


Identifies the image mapping file. The image mapping file 
can be used to remove images from the output, improve 
the look of shaded images, and substitute existing images 
for images created by the AFP2WEB Transform. Mapping 
images that are common across your AFP documents (for 
example, a company logo) reduces the time required to 
transform documents. If specified, the image mapping file 
must exist in the directory that contains the AFP2WEB 
Transform programs. See the AFP2WEB Transform 
documentation for details about the image mapping file. 


Note: ODWEK sends the following options to the AFP2WEB Transform when 
converting documents. These options are not specified in the 


AFP2HTML.INI file. 


* Orientation. Determines the rotation value to use when viewing the 
document. The default value is derived from the Orientation setting on 
the View Information page in the OnDemand application. 


* Image Color. Determines the color to use when viewing images and 
graphics. The default value is derived from the Image Color setting on the 
Logical Views page in the OnDemand application. 


Viewing converted documents 
The UseApplet option in the AFP2HTML.INI file is a directive to ODWEK that 
determines whether the AFP2HTML applet will be used to view the converted 
output. The default value is TRUE. If you specify FALSE, (the AFP2HTML applet 
is not used to view the output), then the output is formatted and displayed by the 


Web browser. 


In general, IBM recommends that you always use the AFP2HTML applet to view 
converted documents. If a document was stored in OnDemand as a large object, 
then the AFP2HTML applet adds controls to help users easily move to any page in 


the document. 
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Appendix B. AFP to PDF transform 


The AFP2PDF Transform converts AFP documents and resources into PDF 
documents. The AFP2PDF Transform is a services offering from IBM Printing 
Systems Division. An administrator must install and configure the AFP2PDF 
Transform on the Web server. See your IBM representative for more information 
about the AFP2PDF Transform services offering. Someone in your organization 
must also specify configuration options for the AFP documents and resources that 
you plan to process with the AFP2PDF Transform. This section describes how to 
specify the configuration options. 


Note: In this document, the name AFP2PDEINI refers to the configuration file. To 
specify the file that contains the configuration options, see |“CONFIGFILE” 
ion page 19 


The AFP2PDE.INI file provides configuration options for the AFP2PDF Transform. 
You typically configure the AFP2PDE.INI file with options for specific AFP 
applications. However, you can also provide a set of default options. The AFP2PDF 
Transform uses the default options when converting documents and resources for 
AFP applications that are not identified in the AFP2PDF.INI file. To learn more 
details about the options and the conversion process, see the AFP2PDF Transform 
documentation. 


The following topics provide additional information about the AFP2PDFINI file: 
* Specifying the AFP2PDF.INI file 
* Viewing converted documents 


Note: To convert documents, you must also specify the AFPVIEWING=PDF parameter 
in the DEFAULT BROWSER section (or other browser sections) of the 
ARSWWWAINI file. See EARP VIEWING? on pace 7for details. (If you plan 
to use the Retrieve Document API, then you should specify the _afp=PDF 
parameter. See for details.) 
Specifying the AFP2PDF.INI file 


The following is an example of an AFP2PDFINI file: 


[CREDIT-CREDIT] 
OptionsFile= 
ImageMapFile=creditImageMap.cfg 


[default] 

OptionsFile= 

ImageMapFi le=imagemap.cfg 
Al1l0bjects=0 


The structure of the file is similar to a Windows INI file, and contains one stanza 
for each AFP application and one default stanza. The title line of the stanza 
identifies the application group and application. For example, the title line: 


[CREDIT-CREDIT] 


Identifies the CREDIT application group and the CREDIT application. Use the — 
(dash) character to separate the names in the title line. The names must match the 
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application group and application names defined to the OnDemand server. If the 
application group contains more than one application, then create one stanza for 
each application. 


The parameters that you specify in the [default] stanza are used by the AFP2PDF 
Transform to process documents for AFP applications that are not identified in the 
AFP2PDEINI file. The default parameters are also used if an AFP application 
stanza does not include one of the parameters specified. 


The OptionsFile parameter identifies the full path name of the file that contains 
the transform options used by the AFP2PDF Transform. The transform options are 
used for AFP documents that require special processing. See the AFP2PDF 
Transform documentation for details about the transform options file. 


The ImageMapFile parameter identifies the image mapping file. The image 
mapping file can be used to remove images from the output, improve the look of 
shaded images, and substitute existing images for images created by the AFP2PDF 
Transform. Mapping images that are common in most of your AFP documents 
(such as a company logo) reduces the time required to transform documents. If 
specified, the image mapping file must exist in the directory that contains the 
AFP2PDF Transform programs. To specify the directory that contains the programs 
for the AFP2PDF Transform, see["INSTALLDIR” on page 19] See the AFP2PDF 


Transform documentation for details about the image mapping file. 


The Al10bjects parameter determines how ODWEK processes documents that are 
stored as large objects in OnDemand. The default value is 0 (zero), and means that 
ODWEK will retrieve only the first segment of a document. If you specify 1 (one), 
then ODWEK will retrieve all of the segments and convert them before sending the 
document to the client. Note: If you enable large object support for very large 
documents, then your users may experience a significant delay before they can 
view the document at the client. 


Viewing converted documents 
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To view converted documents with the Adobe Acrobat viewer, you must obtain the 
viewer for the browsers used by your organization. 
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Appendix C. API reference 


This chapter contains information about the programming functions that are 
available with ODWEK. This chapter is of primary interest to programmers 
responsible for integrating ODWEK with Web browsers. 


Note: Parameter values are standard text. It is possible that the text could consist 
of characters that will confuse browsers. To prevent possible errors, you 
must code all special characters in their corresponding hexadecimal codes. 
These special characters include control characters and certain alphanumeric 
symbols. For example, the string: 


The post date is 12/31/95 


would be converted to: 
The%20post%20date%201s%2012%2f31%2F95 


Parameter values include folder names, folder field names, and search 
criteria. 
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Add Annotation 


Add an annotation to the specified document 


Purpose 


The Add Annotation function enables users to add an annotation to the specified 
document. To add an annotation, the user must be given the Add Annotation 
permission in the OnDemand application group. (The Access permission also lets 
users add annotations.) 


Parameters 


Table 3. Add Annotation function 


Name=Value 


Purpose 


_function=addnote 


Add an annotation. 


_server=value 


The name of the OnDemand server. 


_user=value 


The OnDemand userid. The user must be given the Annotation Add 
permission for each application group that contains documents to be 
annotated. (The Application Group Access permission lets users add 
annotations.) 


_password=value 


_folder=value 


The password for the user. 


The name of the folder. 


_perm=value 


Determines whether the annotation is Public (0), Private (1), or Private for 
Group (2). Public annotations can be viewed by any user with View 
Annotation permission for the application group. Private annotations can be 
viewed by the user that created the annotation, application group 
administrators, and system administrators. Private for Group annotations 
can be viewed by users in the specified group, application group 
administrators, and system administrators. The _group parameter contains 
the name of the group. The default value is 0 (Public). 


_group=groupName 


If the _perm parameter is set to 2 (Private for Group), names the group. 


_copy=value 


_text=value 


Determines whether the annotation should remain attached to the document 
if the document is exported to another server. The default value is off, 
meaning the annotation is not attached to the document. A value of on 
means the annotation is attached to the document if the document is 
exported to another server. 


The text of the annotation. 
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Table 3. Add Annotation function (continued) 


Name=Value 


Purpose 


_html=value 


_nohtml=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, ODWEK uses the ADDNOTE.HTML file found in the 
directory named by the TEMPLATEDIR parameter in the ARSWWWLINI file. If 
the value is a file name without a path name, the file must be located in the 
directory named by the TEMPLATEDIR parameter. If the value includes a path 
name, the path should be relative to the directory named by the 
TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HITM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the add an annotation function. 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
one), then ODWEK generates delimited ASCII output. See 
“No HTML output” on page 83}for details about the delimited ASCII output. 


_docid=documentID 


The identifier of the document to which the annotation is to be attached. 
The document identifier is returned by the Document Hit List function. 


_port=value 


_codepage=vwalue 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 


The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWAINI file. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=addnote 
&_server=0d400&_user=web&_password=web 

& folder=credit%20card%20statements 

& text=Test%20note%20from%20the%200nDemand%20Internet%20C1ient 

& _docid=6850-6851-SUA17-1FAAA-225712-1634-132014-132172-89-76-11-25-0 


& _perm=1 
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Change Password 


Change the OnDemand logon password 


Purpose 


The Change Password function permits users to change their OnDemand 


passwords. 


Parameters 


Table 4. Change Password function 


Name=Value 


_function=chgpassword 


Purpose 


Change the OnDemand password for the userid. 


_server=value 


_user=value 


The name of the OnDemand server. 


The OnDemand userid. 


_password=value 


The password for the userid. 


_nhew_password=vwalue 


The new password for the userid. 


_html=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the CHGPASSWORD.HTML file 
found in the directory named by the TEMPLATEDIR parameter in the 
ARSWWWIAINI file. If the value is a file name without a path name, then the 
file must be located in the directory named by the TEMPLATEDIR parameter. If 
the value includes a path name, the path should be relative to the directory 
named by the TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the change password function. 


_nohtml=value 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
(one), then ODWEK generates delimited ASCII output. See|Appendix G, 
“No HTML output” on page 83}for details about the delimited ASCII output. 


_port=value 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 


_codepage=value 


The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWAINI file. 
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Table 4. Change Password function (continued) 


Name=Value Purpose 


_cgibin=program Used by the CGI program when generating the next output page. If 
specified, then the page will contain a call to the specified program instead 
of the default program (ARSWWW.CGI). This parameter is primarily used 
by programmers who are creating a front-end CGI program or servlet to the 
CGI program or servlet provided by IBM. 


The program can name a directory that is relative to the ServerRoot directive 
or name an alias that is defined in the Web server configuration file. By 
default, ODWEK retrieves the CGI program from the CGI-BIN directory. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=chgpassword 
& _server=0d400&_user=web& _password=web 
&_newpassword=newpw&_html=template.htm 
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Document Hit List 


Display the list of documents that match the search criteria 


Purpose 


The Document Hit List function displays the list of documents that match the 
search criteria for a specific folder. Each document is represented by a link to the 
document on the OnDemand server. After clicking a document, ODWEK retrieves 
the document from the server and displays it in the browser window using the 
appropriate viewer. 


Parameters 


Table 5. Document Hit List function 


Name=Value 


Purpose 


_function=dochitlist 


Display list of documents that match the search criteria. 


_server=value 


The name of the OnDemand server. 


_user=value 


The OnDemand userid. 


_password=value 


The password for the userid. 


_folder=value 


The name of the folder. 


folder field name=value 


The name of a folder search field and the search value. You can specify one 
or more sets of field names and search values, up to the number of fields 
defined for the folder. 


folder field name2=value 


For folder search fields that use the BETWEEN or NOT BETWEEN search 
operators, the upper value with which to search the field. 


_display_fields=value[,value,...] 


A comma separated list that contains the names of the folder display fields. 
You can specify one or more field names. If you do not specify this 
parameter, the output page contains all of the folder display fields. 


_sort_field=value 


Determines the folder search field that OnDemand uses to sort items in the 
document list. 


_sort_order=value 


If the sort_field parameter is specified, determines whether OnDemand sorts 
items first to last or last to first. Specify an A (ascending) to sort items first 
to last. Specify any other character to sort items last to first (descending). 


_max_hits=value 


Determines the maximum number of items that ODWEK returns to the 
document list, regardless of the number of items that match the query. 
ODWEK fills the document list with items that match a query in the order 
in which matching items were loaded into the database. 


ODWEK uses the first value specified to determine the number of items to 
return to the document list: 


1. The value of the Maximum Hits field (specified on the folder 
Permissions page). This value overrides all other values. 


2. The value of the _max_hits parameter, if specified. This value overrides 
the MAXHITS parameter from the ARSWWWLINI file. 


3. The value of the MAXHITS parameter, if specified. 


4. If none of the above are specified, ODWEK returns a maximum of 200 
items to the document list. 
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Table 5. Document Hit List function (continued) 


Name=Value 


Purpose 


_html=value 


_frame=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the DOCHITLIST.HTML file found 
in the directory named by the TEMPLATEDIR parameter in the ARSWWW.INI 
file. If the value is a file name without a path name, then the file must be 
located in the directory named by the TEMPLATEDIR parameter. If the value 
includes a path name, then the path should be relative to the directory 
named by the TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the document hit list function. 


The output of this command will include a target=value attribute. This 
parameter makes building HTML frames simpler. This is an optional 
parameter. 


_datefmt=value 


Determines the format of date values used by ODWEK to search the 
database and display items that match a query. The default date format is 
set on the folder Field Information page. See the IBM Content Manager 
OnDemand for iSeries VSR1 Common Server Administration Guide, SC27-1161 
for details about date formats supported by OnDemand. 


_nohtml=value 


_port=value 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
Tet ODWEK EEL delimited ASCII output. See[Appendix G, "No 
for details about the delimited ASCII output. 
The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 


_codepage=value 


The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWAINI file. 
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Table 5. Document Hit List function (continued) 


Name=Value 


Purpose 


_sql=string 


Specifies the SQL query that OnDemand uses to search the folder. If you 
specify this parameter, the SQL query is used to search the folder rather 
than any folder field name/value pairs that may be specified. OnDemand 
does not validate the query string. 


When using an SQL string, you must specify application group database 
field names and values. If you plan to query date fields, you must specify 
OnDemand internal date values. For example, the date January 1, 1999 
would be specified as 10593. You can use the ARSDATE command to list the 
internal date value for a given date. 


The SQL string is used to search all of the application groups contained in 
the folder. If the SQL string contains a database field name that is in one 
application group but not in another application group, then the query will 
fail. 


_datel=value 


Use to specify the beginning date in a range of dates to search. If you 
specify the _datel and _date2 parameters, OnDemand limits the query to 
the table or tables that contain one or both of the specified dates. The format 
of the date string that you specify must match the display format of the 
folder field. (You can use the administrative client to list the display format 
of the folder field.) 


_date2=value 


Use to specify the ending date in a range of dates to search. If you specify 
the _datel and _date2 parameters, OnDemand limits the query to the table 
or tables that contain one or both of the specified dates. The format of the 
date string that you specify must match the display format of the folder 
field. (You can use the administrative client to list the display format of the 
folder field.) 


_cgibin=program 


Used by the CGI program when generating the next output page. If 
specified, then the page will contain a call to the specified program instead 
of the default program (ARSWWW.CGI). This parameter is primarily used 
by programmers who are creating a front-end CGI program or servlet to the 
CGI program or servlet provided by IBM. 


The program can name a directory that is relative to the ServerRoot directive 
or name an alias that is defined in the Web server configuration file. By 
default, ODWEK retrieves the CGI program from the 
/QIBM/Proddata/OnDemand/www/bin directory. 


_or=value 


Specify a 1 (one) to connect search fields using the OR logical operator; an 
item must match at least one of the specified search values. The default 
value is 0 (zero), which means that OnDemand connects search fields with 
the AND logical operator (an item must match all of the specified search 
values). 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=dochitlist 

& server=0d400&_user=web&_password=web 

& folder=credit%20card%20statements 
&account%20number=1000100010009999&date=1%2F1%2 F9b&date2=12%2F31%2F96 
& sort_field=date& sort_order=D&_htm]l=template.htm 
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Logoff 


Logoff an OnDemand server 


Purpose 


The Logoff function attempts to log a user off an OnDemand server. The name of 
the server and the userid to log off are stored in a browser cookie on the client by 
the Logon function. If the server is not a valid OnDemand server, an error message 
is returned. If the userid is not logged on to the specified server, an error message 


is returned. 


Parameters 


Table 6. Logoff function 


Name=Value 


Purpose 


_function=logoff 


Log off an OnDemand server. 


_html=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the LOGOFF.HTML file found in the 
directory named by the TEMPLATEDIR parameter in the ARSWWWLINI file. If 
the value is a file name without a path name, then the file must be located 
in the directory named by the TEMPLATEDIR parameter. If the value includes 
a path name, then the path should be relative to the directory named by the 
TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HITM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the logoff function. 


_nohtml=value 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
one), then ODWEK generates delimited ASCII output. See|Appendix G, 
“No HTML output” on page 83}for details about the delimited ASCII output. 


_port=value 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=logoff 
& html=template.htm 
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Logon 


Logon to an OnDemand server 


Purpose 


The Logon function attempts to access an OnDemand server using the values of 
the server, user, and password parameters. The Logon function verifies that the 
specified user is authorized to logon to the specified server and verifies the 
password. If the user is not authorized to logon to the server, an error message is 
returned. If the server is not a valid OnDemand server, an error message is 
returned. If the password is not valid for the user, an error message is returned. 
After a successful logon, the Logon function displays a Web page that contains a 
list of the folders that the user is authorized to access. 


Parameters 


Table 7. Logon function 


Name=Value 


Purpose 


_function=logon 


Logon to an OnDemand server. 


_server=value 


The name of the OnDemand server. 


_user=value 


The OnDemand userid. 


_password=value 


The password for the userid. 


_new_password=vwalue 


The new password for the userid. Allows the password to be changed after 
successfully logging on to the OnDemand server. This is an optional 
parameter. 


_html=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the LOGON.HTML file found in the 
directory named by the TEMPLATEDIR parameter in the ARSWWWLINI file. If 
the value is a file name without a path name, then the file must be located 
in the directory named by the TEMPLATEDIR parameter. If the value includes 
a path name, then the path should be relative to the directory named by the 
TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the logon function. 


_frame=value 


_datefmt=value 


The output of this command will include a target=value attribute. This 
parameter makes building HTML frames simpler. This is an optional 
parameter. 


Determines the format of date values used by ODWEK to search the 
database and display items that match a query. The default date format is 
set on the folder Field Information page. See the IBM Content Manager 
OnDemand for iSeries VSR1 Common Server Administration Guide, SC27-1161 
for details about date formats supported by OnDemand. 
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Table 7. Logon function (continued) 


Name=Value 


Purpose 


_nohtml=value 


_port=value 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 

one), then ODWEK generates delimited ASCII output. See[Appendix G] 
PNG HTML ontput™ os pape tl for details about the delimited ASCII output. 
The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 


_codepage=value 


The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWAINI file. 


_cgibin=program 


Used by the CGI program when generating the next output page. If 
specified, then the page will contain a call to the specified program instead 
of the default program (ARSWWW.CGI). This parameter is primarily used 
by programmers who are creating a front-end CGI program or servlet to the 
CGI program or servlet provided by IBM. 


The program can name a directory that is relative to the ServerRoot directive 
or name an alias that is defined in the Web server configuration file. By 
default, ODWEK retrieves the CGI program from the CGI-BIN directory. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=logon 
&_server=0d400&_user=web&_password=web 
& html=template.htm 
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Print Document (Server) 


Sends one or more documents to the specified server printer 


Purpose 


The Print Document function sends copies of documents to an OnDemand server 
printer. To use the server print facility, the user must be given the Print Document 
permission in the OnDemand application group. (The Access permission also lets 
users print documents.) At least one server printer must be defined on the 
specified OnDemand server. 


Parameters 
Table 8. Print Document function 
Name=Value Purpose 
_function=printdocs Print documents. 
_server=value The name of the OnDemand server. 
_user=value The OnDemand userid. The user must be given the Document Print 


permission for each application group that contains documents to be 
printed. (The Application Group Access permission lets users print 
documents.) 


_password=value The password for the user. 
_folder=value The name of the folder. 
_printer=value The name of the OnDemand server printer. 


When the specified printer is a FAX or a Printer with Information, then you 
can specify the following additional parameters: 


_recv_name=value 
The receiver’s name. 


_recv_comp=value 
The receiver’s company name. 


_recv_fax=value 
The receiver’s fax number. 


_send_name=value 
The sender’s name. 


_send_comp=value 
The sender’s company name. 


_send_tel=value 
The sender’s telephone number. 


_send_fax=value 
The sender’s fax number. 


_send_cover=value 
A user-defined overlay that the Header Page Exit program merges 
with the values of the other parameters to produce a cover page for 
the document. 


_subject=value 
A string that represents the subject of the document. 


_notes=value 
A string that represents a note about the document. 
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Table 8. Print Document function (continued) 


Name=Value 


Purpose 


_html=value 


_nohtml=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the PRINTDOCS.HTML file found in 
the directory named by the TEMPLATEDIR parameter in the ARSWWW.INI 
file. If the value is a file name without a path name, then the file must be 
located in the directory named by the TEMPLATEDIR parameter. If the value 
includes a path name, then the path should be relative to the directory 
named by the TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the print documents function. 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
one), then ODWEK generates delimited ASCII output. See 
“No HTML output” on page 83}for details about the delimited ASCII output. 


_docids=documentIDList 


A list of document identifiers for the documents to be printed. The 
document identifiers are returned by the Document Hit List function. If you 
specify more than one document identifier, then you must separate the 
document identifiers with the \003 character. 

Note: If the number of document identifiers exceeds 200, then you must 
specify the _max_hits parameter. 


_port=value 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 


_codepage=value 


The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWAINI file. 
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Table 8. Print Document function (continued) 


Name=Value 


Purpose 


_max_hits=value 


Use this parameter to specify the number document identifiers to process. 
Specify a value that is equal to or greater than the number of document 
identifiers specified with the _docids parameter. 

Note: If the number of document identifiers exceeds the value specified by 
the MAXHITS parameter in the ARSWWW.CGI file (or 200, if not specified), 
then you must specify the _max_hits parameter. If you do not specify the 
_max_hits parameter (or you do not specify a value for the MAXHITS 
parameter), a maximum of 200 document identifiers will be processed, 
regardless of the number of document identifiers that you specified with the 
_docids parameter. 


ODWEK uses one of the following values to determine the number of 
document identifiers to process: 


* The value of the _max_hits parameter, if specified. This value overrides 
the value of the MAXHITS parameter. 


* The value of the MAXHITS parameter, if specified. 


* If none of the above are specified, ODWEK processes a maximum of 200 
document identifiers. 


Sample Function Call 


62 IBM Content Manager OnDemand for iSeries Common Server: Web Enablement Kit Installation and Configuration Guide 


http://www. company.com/cgi-bin/arswww.cgi?_function=printdocs 

& server=0d400&_user=web&_password=web 

& folder=credit%20card%20statements 

&_printer=infoprint60 
&_docids=6850-6851-SUA17-1FAAA-225712-1634-132014-132172-89-76-11-25-0 


Retrieve Document 


Purpose 


The Retrieve Document function retrieves the selected document from the 
OnDemand server. ODWEK displays the document in the browser window using 
the applet, viewer, or other program that is associated with the document type. 


Parameters 


Table 9. Retrieve Document function 


Retrieves the selected document from OnDemand 


Name=Value 


Purpose 


_function=retrieve 


Retrieve the selected document. 


_server=value 


The name of the OnDemand server. 


_user=value 


The OnDemand userid. 


_password=value 


The password for the userid. 


_folder=value 


The name of the folder. 


folder field name=value 


The name of a folder search field and the search value. You can specify one 
or more sets of field names and search values, up to the number of fields 
defined for the folder. 


_html=value 


When an error occurs retrieving a document, determines the HTML file that 
ODWEK uses as a template to generate the (error) output Web page. The 
value can be a file name or an * (asterisk). If the value is an asterisk, then 
ODWEK uses the RETRIEVE.HTML file found in the directory named by 
the TEMPLATEDIR parameter in the ARSWWWAINI file. If the value is a file 
name without a path name, then the file must be located in the directory 
named by the TEMPLATEDIR parameter. If the value includes a path name, 
then the path should be relative to the directory named by the TEMPLATEDIR 
parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the retrieve function. 


_nohtml=value 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
one), then ODWEK generates delimited ASCII output. See|Appendix G, 
“No HTML output” on page 83}for details about the delimited ASCII output. 


_port=value 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 
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Table 9. Retrieve Document function (continued) 


Name=Value 


Purpose 


_codepage=value 


The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWAINI file. 


_cgibin=program 


Used by the CGI program when generating the next output page. If 
specified, then the page will contain a call to the specified program instead 
of the default program (ARSWWW.CGI). This parameter is primarily used 
by programmers who are creating a front-end CGI program or servlet to the 
CGI program or servlet that is provided by IBM. 


The program can name a directory that is relative to the ServerRoot directive 
or name an alias that is defined in the Web server configuration file. By 
default, ODWEK retrieves the CGI program from the CGI-BIN directory. 


_or=value 


Specify a 1 (one) to connect search fields using the OR logical operator; an 
item must match at least one of the specified search values. The default 
value is 0 (zero), which means that OnDemand connects search fields with 
the AND logical operator (an item must match all of the specified search 
values). 


_afp=value 


When you retrieve an AFP document from the OnDemand server, the value 
of this parameter determines what action, if any, ODWEK takes before 
sending the document to the client. For example, some customers convert 
AFP documents to HTML with the AFP2WEB Transform and use the 
AFP2HTML applet to view the HTML output. Those customers should 
specify _afp=HTML so that ODWEK will convert the AFP document before 
sending it to the client. 


The value can be: 


ASCII ODWEK converts the AFP document to ASCII text. 

HTML ODWEK converts the AFP document to HTML with the 
AFP2WEB Transform. 

NATIVE ODWEK extracts and uncompresses the AFP document 


and its resources from OnDemand. 
Note: If you specify _afp=NATIVE, verify that the MIME 


content type identifies the viewer that you want to use 
(see |“[MIMETYPES]” on page 20|for more information). 


PDF ODWEK converts the AFP document to PDF with the 
AFP2WEB Transform. 
PLUGIN ODWEK does not convert the AFP document (the default). 


_email=value 


When you retrieve an EMAIL document from the OnDemand server, the 
value of this parameter determines what action, if any, ODWEK takes before 
sending the document to the client. The value can be: 


NATIVE ODWEK extracts and uncompresses the EMAIL document 
from OnDemand. 
Note: If you specify _email=NATIVE, verify that the MIME 


content type identifies the viewer that you want to use 
(see |“[MIMETYPES]” on page 20}]for more information). 


HTML ODWEK converts the EMAIL document to HTML. 


64 IBM Content Manager OnDemand for iSeries Common Server: Web Enablement Kit Installation and Configuration Guide 


Table 9. Retrieve Document function (continued) 


Name=Value 


Purpose 


_line=value 


When you retrieve a line data document from the OnDemand server, the 
value of this parameter determines what action, if any, ODWEK takes before 
sending the document to the client. The value can be: 


APPLET ODWEK converts the line data document for viewing with 
the Line Data applet (the default). 

ASCII ODWEK converts the line data document to ASCII text. 

NATIVE ODWEK extracts and uncompresses the line data 


document from OnDemand. 
Note: If you specify _line=NATIVE, verify that the MIME 


content type identifies the viewer that you want to use 
(see |“[MIMETYPES]” on page 20}]for more information). 


_docid=documentID The identifier of the document to be retrieved. The document identifier is 


returned by the Document Hit List function. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=retrieve 
& server=0d400&_user=web& _password=web 

& folder=credit%20card%20statements 
&account%20number=1000100010009999&date=1%2F1%2F96 

& html=template.htm 
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Search Criteria 


Display search criteria for a specific folder 


Purpose 


The Search Criteria function displays the search criteria for a specific folder using a 
form. The user can accept the default search criteria or enter search criteria to 
search for a specific document. After clicking the Submit button, ODWEK displays 
a Web page that lists the documents that match the search criteria. 


Parameters 


Table 10. Search Criteria function 


Name=Value 


Purpose 


_function=searchcrit 


Display search criteria for a specific folder. 


_server=value 


The name of the OnDemand server. 


_user=value 


The OnDemand userid. 


_password=value 


The password for the userid. 


_folder=value 


The name of the folder to search. 


_html=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the SEARCHCRIT.HTML file found 
in the directory named by the TEMPLATEDIR parameter in the ARSWWW.INI 
file. If the value is a file name without a path name, then the file must be 
located in the directory named by the TEMPLATEDIR parameter. If the value 
includes a path name, then the path should be relative to the directory 
named by the TEMPLATEDIR variable. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOI# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the search criteria function. 


_frame=value 


_datefmt=value 


The output of this command will include a target=value attribute. This 
parameter makes building HTML frames simpler. This is an optional 
parameter. 


Determines the format of date values used by ODWEK to search the 
database and display items that match a query. The default date format is 
set on the folder Field Information page. See the IBM Content Manager 
OnDemand for iSeries VSR1 Common Server Administration Guide, SC27-1161 
for details about date formats supported by OnDemand. 


_nohtml=value 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
one), then ODWEK generates delimited ASCII output. See 
“No HTML output” on page 83}for details about the delimited ASCII output. 


66 IBM Content Manager OnDemand for iSeries Common Server: Web Enablement Kit Installation and Configuration Guide 


Table 10. Search Criteria function (continued) 


Name=Value 


Purpose 


_port=value 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 


_codepage=value 


The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWAINI file. 


_cgibin=program 


Used by the CGI program when generating the next output page. If 
specified, then the page will contain a call to the specified program instead 
of the default program (ARSWWW.CGI). This parameter is primarily used 
by programmers who are creating a front-end CGI program or servlet to the 
CGI program or servlet provided by IBM. 


The program can name a directory that is relative to the ServerRoot directive 
or name an alias that is defined in the Web server configuration file. By 
default, ODWEK retrieves the CGI program from the CGI-BIN directory. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=searchcrit 
& server=0d400&_user=web&_password=web 
& folder=credit%20card%20statements& html=template.htm 
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Update Document 


Updates one or more database values for the specified document 


Purpose 


The Update Document function allows authorized users to update documents. The 
Update Document function updates one or more database values for a specific 


document. 


Parameters 


Table 11. Update Document function 


Name=Value 


Purpose 


_function=updatedoc 


Update the database. 


_server=value 


The name of the OnDemand server. 


_user=value 


The OnDemand userid. The user must have Update document permission 
for the application group. 


_password=value 


The password for the user. 


_folder=value 


The name of the folder. 


folder field name=value 


The name of the field that you want to update and the value that you want 
put in the field. You can specify one or more sets of field names and values, 
up to the number of fields defined for the folder. 


_html=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the UPDATE.HTML file found in the 
directory named by the TEMPLATEDIR parameter in the ARSWWWLINI file. If 
the value is a file name without a path name, then the file must be located 
in the directory named by the TEMPLATEDIR parameter. If the value includes 
a path name, then the path should be relative to the directory named by the 
TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!_ - -AOIJ# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM file is the sample template file provided with 
ODWEK. You can use the sample template file to help create your own 
template file for the update function. 


_nohtml=value 


Determines the type of output generated by ODWEK. The default value is 0 


(zero) and means that ODWEK generates HTML output. If you specify 1 
one), then ODWEK generates delimited ASCII output. See|Appendix G, 
“No HTML output” on page 83}for details about the delimited ASCII output. 


_docid=documentID 


The identifier of the document to be updated. The document identifier is 
returned by the Document Hit List function. 


_port=value 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 
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Table 11. Update Document function (continued) 


Name=Value Purpose 


_codepage=value The code page of the OnDemand database. The default code page is the 
code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWW.INI file. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=updatedoc 
&_server=0d400&_user=web&_password=web 

& folder=credit%20card%20statements 
&account%20number=1000100010009999 

& docid=6850-6851-SUA17-1FAAA-2257 12-1634-132014-132172-89-76-11-25-0 
& html=template.htm 
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View Annotations 


View annotations attached to the specified document 


Purpose 


The View Annotations function enables users to view the annotations attached to 
the specified document. To view annotations, the user must be given the View 
Annotation permission in the OnDemand application group. (The Access 
permission also lets users view annotations.) 


Parameters 


Table 12. View Annotations function 


Name=Value 


Purpose 


_function=getnotes 


View annotations. 


_server=value 


The name of the OnDemand server. 


_user=value 


The OnDemand userid. The user must be given the Annotation View 
permission for each application group that contains annotations to be 
viewed. (The Application Group Access permission lets users view 
annotations.) 


_password=value 


_folder=value 


The password for the user. 


The name of the folder. 


_html=value 


Determines the HTML file that ODWEK uses as a template to generate the 
output Web page. The value can be a file name or an * (asterisk). If the 
value is an asterisk, then ODWEK uses the GETNOTES.HTML file found in 
the directory named by the TEMPLATEDIR parameter in the ARSWWW.INI 
file. If the value is a file name without a path name, then the file must be 
located in the directory named by the TEMPLATEDIR parameter. If the 
value includes a path name, then the path should be relative to the directory 
named by the TEMPLATEDIR parameter. 


The overall content of the HTML file is defined by the customer. However, 
the file must contain the following comment line: 

<!- - -AOI# Marker- - -> 

The location of the comment line determines where ODWEK places its 
output. All lines above the comment line will be written before the output 
generated by ODWEK. All lines below the comment line will be written 
after the output generated by ODWEK. 


The TEMPLATE.HIM is the sample template file provided with ODWEK. 
You can use the sample template file to help create your own template file 
for the view annotations function. 


_nohtml=value 


Determines the type of output generated by ODWEK. The default value is 0 
(zero) and means that ODWEK generates HTML output. If you specify 1 
(one), then ODWEK generates delimited ASCII output. See|Appendix G, 


one), 
“No HTML output” on page 83}for details about the delimited ASCII output. 


_docid=documentID 


The identifier of the document that contains the annotations to be viewed. 
The document identifier is returned by the Document Hit List function. 


_port=value 


The port number for the OnDemand server. The default value, 0 (zero), 
means that the server uses the port number that is specified in the Service 
Table (WRKSRVTBLE). If there is no port number specified in the Service 
Table, then OnDemand attempts to use port number 1445. Any value that 
you specify overrides the value of the PORT parameter in the ARSWWW.INI 
file. 
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Table 12. View Annotations function (continued) 


Name=Value 


Purpose 


_codepage=value The code page of the OnDemand database. The default code page is the 


code page of the Web server. If the code page of the server is different than 
the code page of the database, then you must specify the code page. Any 
value that you specify overrides the value of the CODEPAGE parameter in the 
ARSWWWLINI file. 


Sample Function Call 


http://www. company.com/cgi-bin/arswww.cgi?_function=getnotes 
&_server=0d400&_user=web& _password=web 

& folder=credit%20card%20statements 

& docid=6850-6851-SUA17-1FAAA-2257 12-1634-132014-132172-89-76-11-25-0 
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Appendix D. Distributing user-defined files 


You can distribute user-defined files with the IBM OnDemand AFP Web Viewer 
software that is supplied by IBM. For example, suppose that someone in your 
organization creates AFP font files for documents that are stored in OnDemand. 
You can distribute the font files with the AFP Web Viewer software. That way, 
when a user views an AFP document, the document will be displayed with the 
correct fonts. 


To distribute user-defined files with the AFP Web Viewer, you must package the 
files into an installation file and store the installation file in a shared location. 
When a user runs the installation file, the Setup program automatically installs the 
AFP Web Viewer and the user-defined files on the user’s workstation. 


You can distribute the following types of user-defined files with the AFP Web 
Viewer: 


* AFP font files. These files are copied to the FONT subdirectory of the AFP Web 
Viewer destination directory on the workstation. 


* Adobe Type 1 font files. These files are copied to a directory specified by the 
user and installed in ATM by the Setup program. 


Note: If ATM is not installed on the user’s workstation, the Setup program 
copies the font files to a directory specified by the user. However, the 
Setup program does not install the fonts. If the user installs ATM on the 
workstation after running the installation file, then the user can install the 
fonts from the ATM applet in Control Panel. 
* TrueType font files. These files are copied to the Windows FONTS directory and 
installed in Windows by the Setup program. 
* Miscellaneous user-defined files. These files are copied to the AFP Web Viewer 
destination directory on the user’s workstation. 


Note: The Setup program copies user-defined files to the workstation after the 
AFP Web Viewer files that are supplied by IBM. If you name a user-defined 
file the same as one of the files supplied by IBM, then the user-defined file 
will replace the file supplied by IBM. You can take advantage of this feature, 
for example, to distribute an updated FLDPORT2.INI file or to distribute 
IBM AFP font files that your organization has modified. 


The following topics contain more information about configuring and distributing 
the AFP Web Viewer: 


* Install the AFP Web Viewer files supplied by IBM 

¢ Add subdirectories to hold user-defined files 

¢ Store user-defined files in subdirectories 

* Configure font files 

¢ Build the AFP Web Viewer installation file 

¢ Install the AFP Web Viewer on a user’s workstation 
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Installing the AFP Web Viewer files 


Most customers use one of two ways to distribute the viewer files from a server, 
depending on whether they plan to distribute user-defined files with the AFP Web 
Viewer: 


* Standard Install. Use to distribute the AFP Web Viewer files supplied by IBM 
and to prepare for distributing user-defined files with the AFP Web Viewer. 
When an administrator installs the ODWEK software on the Web server, the 
installation files for the viewers are stored in a directory on the server. There 
should be an installation file (EXE) for each viewer and a ZIP archive file for the 
AFP Web Viewer. The administrator typically moves the installation files to a 
public directory on the server and creates a Web page with the links to the files. 
A user installs a viewer by loading the web page into their browser and 
activating the link to the appropriate installation file. 


* Custom Install for the AFP Web Viewer. Use to distribute user-defined files with 
the AFP Web Viewer. 


1. 
2. 


Set up the server for a Standard Install. 


Before any users actually install the viewer, obtain a copy of the AFP Web 
Viewer ZIP archive file. 


Extract the files from the ZIP archive file to an empty work directory. 

Add subdirectories to the work directory and_store user-defined files in the 
directories. See |“ Adding subdirectories”| and |Storing user-defined files” on 
[page 75] for details. 


If distributing user-defined Adobe Type 1 font files, then create a font 
configuration file. See|“Configuring font files” on page 75}for details. 

After all of the directories and files have been configured, create a 
self-extracting EXE file for distribution. See |“Building the AFP Web Viewer 
installation file” on page 76 


for details. 
Replace the EXE file provided by IBM for a Standard Install with the 
self-extracting EXE file that you built. 
After an administrator completes steps|| through |7] users can install the AFP 
Web Viewer and the user-defined files by loading the web page into their 
browsers and activating the link to the updated installation file. 


Adding subdirectories 


The user-defined files that you plan to distribute must be stored in the CUSTOM 
subdirectory tree under the main client installation directory. For example, you 
could name the main client installation directory \ONDEMAND\AFP32. 


To configure the main client installation directory to hold user-defined files: 


1. Create a CUSTOM directory under the main client installation directory. For 
example: 


\ondemand\afp32\custom 


Note: The CUSTOM directory can hold other’ user-defined files that you want 


to distribute to your users. The Setup program copies files from this 
directory to the AFP Web Viewer destination directory on the 
workstation. 


1. Other than AFP font files, Adobe Type 1 font files, and Windows TrueType font files. 
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2. Add one or more of the following subdirectories to the CUSTOM directory. The 
subdirectories you add depend on the type of user-defined files that you want 
to distribute to your users. 

* Create a FONT subdirectory under the CUSTOM directory to hold AFP font 
files (file types FNT and MAP). For example: 
\ondemand\afp32\custom\ font 


The Setup program copies these files to the AFP Web Viewer FONT directory 
on the workstation. 


* Create a TYPEONE subdirectory under the CUSTOM directory to hold 
Adobe Type 1 font files (file types PFB and PFM) and the font configuration 
file. For example: 


\ondemand\afp32\custom\typeone 


The Setup program copies these files to a directory specified by the user and 
installs the fonts in ATM. 


* Create a TRUETYPE subdirectory under the CUSTOM directory to hold 
Windows TrueType font files (file type TTF). For example: 


\ondemand\afp32\custom\truetype 


The Setup program copies files from this directory to the Windows FONT 
directory and installs the fonts in Windows. 


Storing user-defined files 


After extracting the IBM-supplied installation files to the work directory and 
creating the CUSTOM directories, you can store the user-defined files in the 
individual subdirectories. For example, copy Adobe Type 1 font files (file types 
PFB and PFM) that you want to distribute to your users to the 

\ONDEMAND\ AFP32\CUSTOM\TYPEONE directory. 


Configuring font files 


If you plan to distribute user-defined Adobe Type 1 font files to your users, then 
you must complete the following steps: 


1. Store the user-defined Type 1 font files (file types PFB and PFM) in the 
TYPEONE subdirectory of the CUSTOM directory. See |“Adding subdirectories” 
on page 74| for more information. 


2. Create a Type 1 font configuration file. The following information describes 
how to create the Type 1 font configuration file. 


The Type 1 font configuration file must be named ATM_INI.CFG and_must be 
stored_in the TYPEONE subdirectory of the CUSTOM directory. See|“ Adding 


subdirectories” on page 74|for more information about the distribution directories. 


Each record (line) in the Type 1 font configuration file identifies one and only one 
user-defined Adobe Type 1 font that you want to distribute to your users. The 
format of a record is: 


fontname=filename.PFM, filename. PFB 


Where fontname is the name of the Type 1 font as it appears in the ATM Control 
Panel fonts list, filename.PFM is the name of the PFM file for the font, and 
filename.PFB is the name of the PFB file for the font. The following example 
shows a Type 1 font configuration file with two records: 
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Courier, BOLD=coub.pfm,coub.pfb 
SonoranSansSeri f_36,BOLDITALIC=c0a175z0.pfm,c0al75z0.pfb 


The first record in the file identifies the font named Courier,BOLD and its PFM font 
file coub.pfm and PFB font file coub.pfb. The second record in the file identifies the 
font named SonoranSansSeri f_36,BOLDITALIC and its PFM font file c0a175z0.pfm 
and PFB font file c0a175z0.pfb. 


When a user runs a AFP Web Viewer installation file that contains user-defined 

Adobe Type 1 font files, the Setup program processes font files in the following 

way: 

1. Copies all of the user-defined Adobe Type 1 font files (file types PFB and PFM) 
found in the TYPEONE directory to the destination directory. The user specifies 
the destination directory. 


2. Verifies that two font files were copied for each font identified in the Type 1 
font configuration file (ATM_INI.CFG). The name of the files copied to the 
workstation must match the names specified in the font configuration file. 


Note: If the names of the font files specified in the font configuration file do 
not match the names of the files copied to the workstation, the Setup 
program displays a warning message and does not install the font. 


3. Adds path information for the PFB and PFM files, using the destination 
directory specified by the user. 


4. Installs the fonts in ATM. 


Note: If ATM is not installed on the user’s workstation, then the Setup program 
copies the font files to a directory specified by the user. However, the Setup 
program does not install the fonts. If the user installs ATM on the 
workstation after running the installation file, then the user can install the 
fonts with the ATM applet in Control Panel. 


Building the AFP Web Viewer installation file 


After you have finished creating directories and storing files in the CUSTOM 
directory tree, you must create an installation file that contains your user-defined 
files and the AFP Web Viewer files supplied by IBM. The installation file is usually 
named Setup.exe. 


Several companies make software for packaging files and applications into a single, 
self-extracting AFP Web Viewer executable file for distribution. For example, the 
InstallShield Software Corporation offers a product called PackageForTheWeb. 


Note: Software provided by other companies is not supported by IBM. 
After you have obtained the packaging software, run it and follow the instructions 


provided to create a AFP Web Viewer installation file that contains your 
user-defined files and the AFP Web Viewer files supplied by IBM. 


Installing the AFP Web Viewer on a user’s workstation 


After you set up the CUSTOM directory tree, build the AFP Web Viewer 
installation file, and replace the AFP Web Viewer installation file on the server, 
users can begin installing the AFP Web Viewer and the user-defined files. The next 
time a user activates the link to the AFP Web Viewer installation file from the 
server, the Setup program installs the AFP Web Viewer on the user’s workstation 
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and copies all of the user-defined files that you packaged with the AFP Web 
Viewer installation file to the user’s workstation. 
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Appendix E. HTTP server configuration files 


This section contains examples of the following HTTP server configuration files: 
* HTTP Original Server 
* HTTP Apache Server 


Note: Please consult your HTTP documentation for configuration assistance. 


HTTP Original Server 


Notes: 


1. In the HostName line, replace the string n.n.n.n with the IP address of the 
iSeries machine that is running the OnDemand server software. 


2. In the Port line, replace p with the TCP/IP port number used for the client and 
HTTP server to communicate. The default TCP/IP port number is 80. 


# IBM HTTP Original Server configuration file 

BindSpecific On 

HostName n.n.n.n 

Port p 

Pass /applets/* /QIBM/ProdData/OnDemand/www/applets/* 

Exec /scripts/arswww.cgi /QSYS.LIB/QRDARS.LIB/ARS3WCGI.PGM 
Exec /scripts/arswww.cgi/*.*/QSYS.LIB/QRDARS.LIB/ARS3WCGI .PGM 
Pass /logon /QIBM/UserData/OnDemand/www/samples/logon.htm 
Pass /images/* /QIBM/UserData/OnDemand/www/images/* 
ErrorLog /QIBM/UserData/OnDemand/www/logs/error_log 2000 *DFT *DFT 
CgiErrorLog /QIBM/UserData/OnDemand/www/logs/cgi_error 2000 
ErrorLogArchive None 

ErrorLogExpire 0 

ErrorLogSizeLimit 0 

CGIConvMode %%EBCDIC/MIXED%% 

MaxContentLengthBuffer 100 K 

CgiThreadedMode Off 

Disable CONNECT 

Disable DELETE 

Disable PUT 

Enable GET 

Enable HEAD 

Enable OPTIONS 

Enable POST 

Enable TRACE 

UserID %%SERVER%% 

DNS-Lookup On 

RuleCaseSense Off 

Imbeds CGI htm] 

MultiFormatProcessing Multi 


HTTP Apache Server 


Notes: 


1. In the Listen line, replace the string n.n.n.n with the IP address of the iSeries 
machine that is running the OnDemand server software. 


2. In the Listen line, replace p with the TCP/IP port number used for the client 
and HTTP server to communicate. The default TCP/IP port number is 80. 
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80 


3. In the ServerName line, replace the string f.q.h.n with the fully-qualified 
TCP/IP host name of the iSeries machine that is running the OnDemand server 
software. 


#HTTP Apache Server Configuration for the ODWAPACHE server 
Listen n.n.n.n:p 

HostNameLookups off 

RuleCaseSense OFF 

LimitRequestBody 102400 

ErrorLog /www/odwapache/logs/error_log 
ServerName f.q.h.n 

DocumentRoot /www/odwapache 
UseCanonicalName Off 

CGIConvMode %%EBCDIC/MIXED%% 
ScriptLogLength 200 

ScriptLog /www/odwapache/logs/cgi_log 


Alias /logon /www/odwapache/odw_logon.htm 

AliasMatch “/images/(.*)$ /QIBM/UserData/OnDemand/www/images/$1 
AliasMatch “/applets/com/ibm/edms/od/(.*)$ | /QIBM/ProdData/OnDemand/www/applets/$1 
AliasMatch “/applets/(.*)$ /QIBM/ProdData/OnDemand/www/applets/$1 
ScriptAliasMatch “/scripts/arswww.cgi$ /QSYS.LIB/QRDARS.LIB/ARS3WCGI .PGM 


ScriptAliasMatch */scripts/arswww\.cgi/(.*)$ /QSYS.LIB/QRDARS.LIB/ARS3WCGI.PGM 
AddType www/unknown cab 
AddType www/unknown jar 
AlwaysDirectoryIndex On 
DirectoryIndex index.html 
<Directory/> 
Options None 
Options +ExecCGI 
AllowOverride None 
Order deny,allow 
Deny from all 
<LimitExcept GET HEAD OPTIONS TRACE POST PUT> 
</LimitExcept> 
</Directory> 
<Directory /QIBM/ProdData/OnDemand/www/applets/> 
Order allow,deny 
Allow from All 
</Directory> 
<Directory /QIBM/ProdData/OnDemand/www/images/> 
Order allow,deny 
Allow from All 
Options +FollowSymLinks 
</Directory> 
<Directory /QIBM/ProdData/OnDemand/www/samples/> 
Order allow,deny 
Allow from All 
Options +FollowSymLinks 
</Directory> 
<Directory /www/odwapache/> 
Order allow,deny 
Allow from All 
</Directory> 
<Directory /QSYS.LIB/QRDARS.LIB> 
Order allow,deny 
Allow from All 
Options +ExecCGI 
</Directory> 
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Appendix F. Mapping AFP fonts 


AFP fonts that a document was created with need to be mapped to fonts that can 
be displayed using the AFP plug-in. ODWEK provides font definition files that 
map the IBM Core Interchange (Latin only) and compatibility fonts to TrueType 
fonts. The font definition files and font map files are stored in the FONT 
subdirectory in which the AFP Web Viewer code resides. 


If your documents use fonts that are not defined to the AFP Web Viewer, if you or 
others in your organization have modified the IBM Core fonts, or if you or others 
in your organization have created AFP fonts, then you must define the fonts in the 
font definition files so that the AFP Web Viewer can correctly display the 
documents. Refer to the AFP Workbench Technical Reference for details about how to 
map AFP fonts, font definition files, and other technical information related to AFP 
and TrueType fonts. 
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Appendix G. No HTML output 


ODWEK uses the _nohtm1 directive to determine the type of output generated by a 
function (such as Logon). By default, ODWEK generates HTML output. If you 
specify _nohtml=1, then ODWEK generates delimited ASCII output. This chapter 
describes the delimited ASCII output generated by ODWEK. 


Delimited ASCII output 


The delimited ASCH output generated by ODWEK is a set of output records that 
contain character string values, keywords, and function, record, and string 
delimiters and separators: 


* Character string values are output data of a function, other than keywords, 
delimiters, and separators. For example, the next function to be called, the name 
of the folder, the folder field names, search operators, and field values are 
character string values. 


* Keywords consist of a specific character string. For example, ACTION, DOC, 
FOLDER, NUMROWS, and ROW are keywords. 


* The function delimiters consist of the specific character strings [BEGIN] and 
[END]. 

* The record delimiter is the new line character, \n. All records are delimited by 
the new line character. 


* By default, string delimiters and separators are the caret character (A) and the 
left bracket ([) and right bracket (]) characters. For example: 


[folderNamea folderDesc] 


If a keyword record contains more than one character string value, then the 
values are separated by the caret character. Each keyword’s set of character 
string values is delimited by the left bracket and right bracket characters. 


Some character string values may be stored in a list, separated by the caret 
character and enclosed in left bracket and right bracket characters. For example, 
the list of valid search operators for a field may appear as follows: 


[10241816432] 


You can override the default characters for the string delimiters and separators. 


See |“[NO HTML]” on page 25) for details. 


* A single null character string value is indicated by the absence of a value inside 
two double quote characters ('""). A null list is indicated by the absence of a 
value inside left bracket and right bracket characters ([ ]). 


Logon 


The following shows an example of the delimited ASCII output generated by the 
Logon function: 

[BEGIN] \n 

ACTION=searchCriteriaUr]\n 

FOLDER=[folderNamea folderDesc] \n 

FOLDER=[folderNamea folderDesc] \n 
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Notes 


[END] \n 


1. The string searchCriteriaUr] identifies the name of the next function to be 
executed and its parameters. 


2. The string folderName identifies a folder name. The name is not quoted. 


3. The string folderDesc is the description of the folder. The description is not 
quoted. 


Search Criteria 


Notes 


The following shows an example of delimited ASCII data generated by the Search 
Criteria function: 

[BEGIN] \n 

ACTION=hitListUr1\n 

DISPLAY ORDER=[fieldlafield2a...fieldN]\n 

NUMROWS=number0fRows \n 

ROW=[criteriaNamea [[validOp] adefOp] a[inpTypeainpAssocData] \n 


[END] \n 


1. The string hitListUr1 identifies the name of the next function to be executed 
and its parameters. 


2. The DISPLAY_ORDER keyword specifies the order in which the folder fields 
should be displayed. 

3. The string number0fRows identifies the number of ROW keyword records that 
follow. The function generates one ROW keyword record for each search field. 

4. The string criteriaName represents the search criteria for a search field. The 
search criteria is not quoted. 


5. The string validOp is the list of integer values that represent the valid search 
operators for the search field: 


1 Equal 

2 Not Equal 

4 Less Than 

8 Less Than or Equal 


16 Greater Than 
32 Greater Than or Equal 


64 In 
128 Not In 
256 Like 


512 Not Like 
1024 Between 
2048 Not Between 


6. The string defOp is an integer value representing the default search operator. 


7. The string inpType represents the type of search field: 
A Annotation Text Search 
Cc Choice 
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Normal 

Segment 

Text Search 

Annotation Color Search 


NHnZ 


8. The string inpAssocData is a list associated with the defOp and inpType: 


defOp inpType inpAssocData 


Between, Not Between N Null: [ ] 

or a list: [defaultField1,...adefaultFieldN] 
For example: 

["01/31/96"A"01/31/97"] 
["01/31/96"A""] 

[""a"01/31/97"] 


Other valid operators A,N,T, Z Null: [ ] 
or a single string value that represents the 
default field value 


Other valid operators C,S [ [listOfChoices]adefaultChoice] 
For example: 
[["JFIF"A"TIFE"A"PCX"] a" TIFF") 
[["JFIF"a"TI FF"a "PCX"] A iT} "] 


Document Hit List 


The following shows an example of delimited ASCII output generated by the 
Document Hit List function: 

[BEGIN] \n 

ACTION=hitListURL\n 

MSG=Only 20 documents can be listed for this folder. 
DOC=[criterialacriteria2acriteriaVadocidafileTypeadocLocation] \n 


[END] \n 


Notes 


1. The string hitListURL identifies the name of the next function to be executed 
and the parameters for the function. 


2. The MSG keyword shows an example of an error message in the delimited ASCII 
output. By default, ODWEK sends error messages to the client. However, when 
a function contains the _nohtm1=1 directive, ODWEK generates the message text 
in the delimited ASCII output instead. 


3. The strings criterial, criteria2, and criteria represent search criteria 
values. The values are listed in the order in which they appear in the document 
list. The values are not quoted. 


4. The string docid is the document identifier for the document. 


5. The string fileType identifies the data type of the document: 
ALP 

BMP 

Email 

JFIF 

GIF 

Line 

None 


Zr-ortmnp 
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OD Defined 
PDF 
TIFF 
User Defined 
PCX 
e string docLocation identifies the storage location of the document: 
Unknown 
OnDemand cache storage 
Archive storage 
External cache storage 


wNnrRo A xcHHO 


View Annotations 


The following shows an example of delimited ASCII output generated by the View 
Annotations function: 


[BEGIN] \n 

NOTE 4: 15:42:44 PM Mountain Standard Time Thursday November 19, 1998...\n 
Public - Cannot be copied to another server\n 

Test note from the OnDemand Internet Client.\n 

[END] \n 


Error Message 
The following shows an example of delimited ASCII output generated when errors 
occur: 


[ERROR] \n 
ID=nnnn\n 
MSG=errorMessageText\n 


Notes 


1. The string nnnn is the error message number. 
2. The string errorMessageText is the error message text. 
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Appendix H. Problem determination tools 


You can use the tools listed in[Table 13] to gather information about the system and 
documents. You can use the information to help solve problems you are having 
configuring ODWEK and help other people in your organization who are having 
problems using the applets and plug-ins. 


Table 13. Problem Determination Tools 


Tool Purpose How to Enable 


HTML Output Save a copy of the Choose Save As from the browser’s File 
HTML that ODWEK | menu 
is returning to the 
browser. 


Server Log Files Save access Do the following: 


information, errors, 1. In the DEBUG section of the 

and server ARSWWW.INI file, set the LOG 
information. parameter to 1 (one). The log file that is 
generated by ODWEK is named 
ARSWWW.LOG and is written to the 
directory specified by the LOGDIR 
parameter. (The default directory is 
/QIBM/UserData/OnDemand/WWW/LOG.) 


2. Configure logging for your HTTP server. 
(Each HTTP server may have a different 
way to configure logging and may have 
different logs and options you can 
enable to collect more or less detailed 
information.) 


Note: Because a significant amount of 
information can be written to a log file, IBM 
recommends that you enable logging only 
when needed, such as when recreating a 
problem. If you need to enable logging for 
extended periods of time, make sure that 
the log file paths point to storage devices 
with plenty of free space. Remember to 
periodically delete old log files from the 
server. 


Java Console Display messages . 
generated by the 
applets. 


Netscape: From the Communicator menu, 
select Tools and then Java Console. 


¢ Internet Explorer: 


1. From the View menu, select Internet 
Options. 


2. On the Advanced page, select Java 
Console. 


3. Restart the browser. 


4. From the View menu, select Java 
Console. 
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Table 13. Problem Determination Tools (continued) 


Tool 


Purpose 


How to Enable 


AFP Web Viewer 
Trace Facility 


Capture detailed 
information about 
AFP documents being 
viewed with the AFP 
Web Viewer. 


Make sure the following section exists in 
the FLDPORT2.INI file on the user’s 
workstation: 

[Misc] 
ViewTraceFile=d:\temp\afpplgin.log 
Trace=TRUE 


Verify the path of the log file. Remember to 
turn off logging when you have gathered 
the information you need. 


OnDemand System 
Log 


Save system messages 
(such as log on and 
log off) and 
application group 
messages having to 
do with documents 
(such as query and 
retrieve) and 
annotations. 


Do the following: 


1. Enable system and application group 
logging for the OnDemand server. 
Update the system parameters for the 
server using the administrative client. 


2. Enable the specific application group 
messages that you want to log. Update 
the message logging options for the 
application group using the 
administrative client. 
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Appendix I. Notices 


This information was developed for products and services offered in the U.S.A. 


IBM may not offer the products, services, or features discussed in this document in 
other countries. Consult your local IBM representative for information on the 
products and services currently available in your area. Any reference to an IBM 
product, program, or service is not intended to state or imply that only the IBM 
product, program, or service may be used. Any functionally equivalent product, 
program, or service that does not infringe on any IBM intellectual property right 
may be used instead. However, it is the user’s responsibility to evaluate and verify 
the operation of any non-IBM product, program, or service. 


IBM may have patents or pending patent applications covering subject matter 
described in this document. The furnishing of this document does not give you 
any license to these patents. You can send license inquiries, in writing, to: 


IBM Director of Licensing 
IBM Corporation 

North Castle Drive 
Armonk, NY 10504-1785 
U.S.A. 


For license inquiries regarding double-byte (DBCS) information, contact the IBM 
Intellectual Property Department in your country or send inquiries, in writing, to: 


IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106, Japan 


The following paragraph does not apply to the United Kingdom or any other 
country where such provisions are inconsistent with local law: 
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS 
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER 
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS 
FOR A PARTICULAR PURPOSE. 

Some states do not allow disclaimer of express or implied warranties in certain 
transactions, therefore, this statement may not apply to you. 


This information could include technical inaccuracies or typographical errors. 
Changes are periodically made to the information herein; these changes will be 
incorporated in new editions of the publication. IBM may make improvements 
and/or changes in the product(s) and/or the program(s) described in this 
publication at any time without notice. 


Any references in this information to non-IBM Web sites are provided for 
convenience only and do not in any manner serve as an endorsement of those Web 
sites. The materials at those Web sites are not part of the materials for this IBM 
product and use of those Web sites is at your own risk. 
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IBM may use or distribute any of the information you supply in any way it 
believes appropriate without incurring any obligation to you. 


Licensees of this program who wish to have information about it for the purpose 
of enabling: (i) the exchange of information between independently created 
programs and other programs (including this one) and (ii) the mutual use of the 
information which has been exchanged, should contact: 


IBM Corporation 

Software Interoperability Coordinator 
3605 Highway 52 N 

Rochester, MN 55901-7829 

U.S.A. 


Such information may be available, subject to appropriate terms and conditions, 
including in some cases, payment of a fee. 


The licensed program described in this information and all licensed material 
available for it are provided by IBM under terms of the IBM Customer Agreement, 
IBM International Program License Agreement, or any equivalent agreement 
between us. 


Information concerning non-IBM products was obtained from the suppliers of 
those products, their published announcements or other publicly available sources. 
IBM has not tested those products and cannot confirm the accuracy of 
performance, compatibility or any other claims related to non-IBM products. 
Questions on the capabilities of non-IBM products should be addressed to the 
suppliers of those products. 


COPYRIGHT LICENSE: 

This information contains sample application programs in source language, which 
illustrates programming techniques on various operating platforms. You may copy, 
modify, and distribute these sample programs in any form without payment to 
IBM, for the purposes of developing, using, marketing or distributing application 
programs conforming to the application programming interface for the operating 
platform for which the sample programs are written. These examples have not 
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or 
imply reliability, serviceability, or function of these programs. You may copy, 
modify, and distribute these sample programs in any form without payment to 
IBM for the purposes of developing, using, marketing, or distributing application 
programs conforming to IBM’s application programming interfaces. 


If you are viewing this information softcopy, the photographs and color 
illustrations may not appear. 


Trademarks and service marks 


Advanced Function Presentation, AFP, AS/400, IBM, iSeries, Operating 
System /400, OS/400, Redbooks, and WebSphere are trademarks of International 
Business Machines Corporation in the United States, other countries, or both. 


Adobe, the Adobe logo, Acrobat and the Acrobat logo are trademarks of Adobe 
Systems Incorporated, which may be registered in certain jurisdictions. 


Lotus is a trademark of Lotus Development Corporation in the United States, other 
countries, or both. 
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Java and all Java-based trademarks and logos are trademarks or registered 
trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. 


Microsoft, Windows, and Windows NT are registered trademarks of Microsoft 
Corporation in the United States, other countries, or both. 


Other company, product, and service names may be trademarks or service marks 
of others. 
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configuring 47 CODEPAGE parameter 14 
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installing 8 
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parameters 50, 70 
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CONFIGURATION section 11 
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INSTALLDIR parameter 18, 19 
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ARSWWWAINI file (continued) 
LINEVIEWING parameter 29 
LOG parameter 33, 87 
LOGDIR parameter 33 
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PORT parameter 9, 10 
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SERVERPRINTERS parameter 31 
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ASCII output 
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BEGIN parameter 25 
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browser options 
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DEFAULT BROWSER section 26 
browser section 32 
browsers 
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Java Virtual Machine 40 
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cache directory 11 

cache documents 12 

cache size 13 

cache storage 11, 12, 13 

CACHEDIR parameter 11 

CACHEDOCS parameter 12 
CACHEMAXTHRESHOLD parameter 12 
CACHEMINTHRESHOLD parameter 12 
CACHESIZE parameter 13 
CACHEUSERIDS parameter 13 


change password 
API 52 
function description 3 
parameters 52 
sample function call 53 
code page 14 
CODEPAGE parameter 14 
communications protocols 10 
CONFIGFILE parameter 17, 19 
configuration 
AFP2HTML configuration file 43 
AFP2PDF configuration file 47 
ARSWWWAINI file 9 
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Web server 7 
CONFIGURATION section 11 
cookies 29, 40 
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data security 4 
debug section 33 
default browser options 26 
DEFAULT BROWSER section 26 
delimited ASCII output 
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delimiters 25 

document hit list 85 

error message 86 
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generated by OnDemand 83 

logon 83 

messages 86 

search criteria 84 

view annotations 86 
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directory permissions 7 
display document location 31 
document hit list 

API 54 

delimited ASCII output 85 

function description 3 

parameters 54 

sample function call 56 
document location 31 
documents 

AFP 27 

cache storage 12 

converting 27, 28, 29 

EMAIL 28 

line data 29 

links 30 

media type 20 

MIME content type 20 

retrieving 28 

viewing 27, 28, 29 


E 


EMAIL documents 
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ENCRYPTCOOKIES parameter 29 
encryption 29 
ENCRYPTURL parameter 29 
END parameter 25 
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delimited ASCII output 86 
errors 87 
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AFP 81 
mapping 81 
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functions 
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annotations 3, 4 
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logoff 4 

logon 4 

print document 4 
retrieve document 4 
search criteria 4 
server print document 4 
update document 4 
view annotations 4 


G 


GET method 5 
GIF attachments 24 
GIF documents 
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MIME content type 21 


H 


help 87 
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configuration files 79 
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